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Revolution 2.0:the English like language 
designed around the way you think. ^ 

Develop and deliver on 14 platforms, including Mac OS X, Windows and Linux. 

Now with support for XML, additional SQL databases, video capture, Unicode, Reports, 
enhanced faceless CGI applications, and more. The brand new Jaguar friendly user interface 
makes development simple. The new Cookbook of examples lets you get started fast. 

Thousands of developers have already joined the Revolution. Can you afford to wait? 
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worldwide such as Software AG and Citibanks It’s 
integrated seamlessly into c-tree Plus and includes 
complete source code to the server mainline and all the 
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Flexible DBM licensing 
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HELPING FILEMAKEk ru -TO 
SCALE TO NEW HEIGHTS 


Want to enhance the performance 
of FileMaker Pro on MAC OS X? 
The same database engine that 
runs Wall Street can help you do 
just that 


Sybase is helping today's 
leading companies achieve fef 
Information Liquidity; a highly 
profitable state where ail of 
VOUf iirformation is transformed 
into real economic value. 


ASE 12.5 increases the refiabitity, 
availability and scaiability of 
your FileMaker Pro application. 
It provides better data integrity* 
world-class security and the 
ability to handle thousands of 
transactions per minute. It'll 
also give your users the power 
of SQL queries. 


A FREE Developer's Edition 
download is available online 
at sybase^com/fiiemaken « 


ASE 12,5 for MAC OS X is yet 
one more example of how 


SYBASE INTEGRATION TECHNOLOGIES. EVERYTHING WORI 
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GETTING 

STARTED 


Cipyright 200'^ hy Dave Mark 


Getting Started: 
iPod Madness 


OK, ril Iry iu expkiin this as hcsL I am. 

Seems to me it was just a few clays ago when the darn thing 
arrived. 1 h:id already started writing my WWDC colinnn. 
Basically, a follow-on to last months TinyViewer Interface 
Builder column. 

'I'hat's when the dooriieli rang. 

It was an innocuous looking package, return address 
Apple Computer, Cupertino, California. [ immediately ripped it 
open, ignored the disk and other trimmings, and pulled 
out...COOL..a new iPod! Better put it aside - gotra get that 
column finished. 

linn...it's just so shiny. Must focus. Must put down shiny 
iPod. 

With great force of will, 1 pul the iPod hack in its hox and 
returned to iny computer. And that's when I got the email. Guess 
what, Dave? Ihe new iPods support this coo\ new markup 
language so you can create your own linked iPfxi conteni. Wlia? 
Huh? And there are tliese cool new AppleScrifits you can play 
with to manage your iPod notes? 

11 wa.s all over. All .semblance of willpower wa.s I fist. iPotl 
madness had La ken over. 

iPod Notes 

As you can tel], I the new^ iPfxJs. The case design is 
gorgeous. Tlie new de.sign is much slimmer and the ccmtj-ols 
.sleeker. The 15 and 30 gig units ship with a cradle and the cradle 
wfjrks c|uile vvelk Tie it ail up with a new iTunes release and the 
integrated iTunes Music Store and you’ve got a marketing 
wincllall for Apple. Qin you say ka-cbing^ 

When you doubleclick your iPod's Finder icon, you 11 see 
three tot>level Ibldej-s: CaicrtdtifS, Coiuacis, and Notes. Any 
items placed in the Notes folder are fair game for the Note 
Header, an app built into each of the new iPods (but, sadly, not 
in any of the older nuxleis). 

By default, the iPod ships with a single Ole, tiamed 
tmtmctiom, in the Notes folder. ‘Ihe Instructions Ole consists of 
a single text siring, ‘'<INSTRUCTIONS>”. Welcome to your Orst 


il\jd Notes tag. Though not particularly useful for your purposes, 
the <lNSrRUC110NS> tag tells tlie Notes Reader to display a 
simple .set of insimciioas built into the iPod. One cool thing 
about this tag. Change the language, the instruction language 
changes. Change the language setting to Espanol, and die 
inslruclioas appear in Spanish. As it shoukl l>e. 

From die u.sePs perspective, the Notes folder is simply a 
colleaing point for relatively small (notes are limited to 4kb “ 
any biggei', they get truncated) text files. Got a collection of 
recipes? Put one per file in a collection of folders and drag the 
folder hierarchy to the iPod's Notes folder. For example, you 
might organize your recipes in a Recipes folder, with subfolders 
for Soups, Hof^ D oetwres^ Salads, Entrees, and Desserts. You 
might store each recipe in its own text file, then organize the 
text Files in the correct folder (soup recipe files in the Soups 
folder, etc.). Now drag the entire Recipes folder into the iPod’s 
Notes folder. 

If you are tiying diis at home, be sure the Enable FireWire 
disk use checkbox is checked in the iPtxl preferences in 
iTunes 4. If you can’t find that preference, attach yoLir 
iPod to your Mac. Then, when it appears in the iTunes list, 
click on the iPod’s icon in the list on ihe lefThand-side, 
then click die iPod icon on the l>ottom-righL ct)mer of ilie 
window (leftunost of the 4 bottom icons). 

When you fire up your iPod, click on Extras, then Notes. On 
the Notes page, you 11 see Instnutious as well as a Recipes item. 
Select ReeijK^s and you 11 see the Soups, IJors D'oeuwes, Salads^ 
Entrees, and Desserts foldcT (see Figure II. Select Soups, youll 
see a list of the Soups text files. Select one of those and the text 
from that file is displayed. 'I'o get back, click the Menu button. 
Note that the Mefiu button is more like a lirowser’s back Imtton 
than a '‘move up a level" button. When you start playing with 
links, you'll see what I mean. 


Dave Mark is a long-tiiTie Mac develoi^er and blah, blah, l:^la]l... We intemipt this inipirtant hio to bring you an important message: Gonna l>e at 
WWDC? Be sure to find Dave and say lii (His pic is up on mactech.com and spiderwofks.com). Bring your cominenis, suggesiions, and maybe even a nice 
piece of gum. © 
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Figure L Ihe Recipes categories on my iPoci. 


LimitatiorLs: A single note can be up to 4kl). The current 
iPods support up to 1,000 notes. The Notes cache is 64ki>. 
Once the cache is exceeded, the cache is flushed, tlie 
hard drive spins up and new notes are cached as needed. 

iPod Note Tags 

Currently, the Notes Reacier supports a very small set of 
HTML tags. All Uigs arc catse insensitive. 

Use <BK> or the paidng of <P> and </P> to force a 
pantgraph break in your running text. 

You'll trse <T1TLE> and </nTI.E> to create a title for your 
page. If your text Ole does not contain a <11TLE> tag, the file 
name is used as the title, if the <4TH» tag is there, the 
<TITLE> specified will he displayed at the top of the screen 
when the text file is shown, and is also used in the scrolling list 
that contains the text tile. 

Want the official doc on Notes Reader? Check out: 

httpV/developer.apple.com/hardware/ipod/index.html 

Link Tag?> 

The iPod link tag looks just like iLs HTML counterpail and 
aUows you to link notes tt)gether. Here’s an example, I started by 
( featinga text file named Ideal Meal, ,saving it in the Rectlm fokkx: 

<TITLE>Ait Ideal MeaK/TITLE> 

The Ideal meal always start with a nice piece 
□f <A UREF-^]kilvatr>halvah</A>* followed immediately by a 
healthy serving of Mama's secret (A HREF=’'Gravlax")gravlax 
recipe</A> 


I liien created a file called Halvab, afso saving it in the 
Recipes folder: 

<TITLE>HaIvah</TITLE) 

A confection made out of crushed sesame seeds and honey. 

Have a nice piece of Halvah today. It couldn't hoit. Goes 
well with <A HREF=*'Gravlax'’>gravlaK</A>. 

<BR>(BR>Back to <A HliEF='’/RecIpes >Recl pes (/A>. 


And Rnally, a file called O'mvlax, also saved in the Recipes 
folder: 

<TTTLE>Gravlax</TTTt,E> 

Raw salmon, usually seasoned with dill* Have a nice piece of 
gravlax with your <A iIREF=''Ilalv3h">halvah</A>. Eat* Eat. 

A note on editing your note files* If you use an editor like 
Word, be sure smart quotes are airneci off. When I 
created some notes with smart quotes, the iPod displayed 
iliem with extreme funkiness. Tliis is Ixjcause the text 
encoding used by Word does not match the default 
encoding of the Notes Reader. Moj'e on this in next 
month's column. 

Also, don't put a hard return in your notes unless you 
really want a hard return in there. When 1 me BBEdii, 1 
select Text Options from tlie Edit menu, tlien t4ick the 
Soft Wrap Tk^xt radio button and set it to Window Width. 
Remenilx?r, this is rev 1 of iPod Notes. Over time, 1 
suspect well see tiiore tags and cKher text handling 
optiems. And a color screen? With image tag support and 
an Etliemet port? Huh? Couldja? Please? © 

Figure 2 shows the Reci}m notes folder after I copied my 
3 new notes over to the iPod. 



figure Z The Recifm jblder imih J added files. 


Click on An Ideal Meal (Figure 3), Notice that there are 2 
links in this text. The first link is .selected by default, with the 
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undcrime of thu second link Ixirely visit>le. How do you get from 
link to link? I'he scroll wheel, of course! StTolling the wheel 
countercicx’kwise moves you up a link, stepping from link to 
ILnk, ,sU)j>ping at the first one on the page. Sixolling the wheel 
clockwise moves you down the t>age, link l>y link. Keep 
scrolling and you stop at the hist link on the page. Hiere is no 
wraparound effect if you keep sc’rolling. 

^mJJ II .UWJ. 1 ,n J.H II L. I ■ m I I I . fill I ■! II . . ■l l.jpjn i j ll ■Ii n 

Rrt Ideal Neal 

--- i 

The ideal meal always startsi i 
‘With a nice piece of halvah. 
followed immediatelff by a 
healthy serving of Mama's 
secret qravlax recipe 



Hgtire 3 , What haplmis when i dick on An ideal Meal, 


Figure 4 shows the Gradax note, witli the halmh link 
selected. Click on the halvah link and you1l jump to the 
Halmh note (Figure 5). Note that if you keep selecting links, 
you'll pop back and fonh between Graviax and Halmh. The 
interesting thing here is that the links are stacked (like a 
browser), so when you click the Menu button, you 11 lx)unce 
back to the previous page, as opposed to moving up in the 
folder hierarchy. 



Figure 4 7he Gradax note, uHtb a link to halmh. 



Fetch 


Woof. 



Fetchsoflworks.com 


Version 4.0.3 now available. 
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NoLc that the Halvah note contains a Imk back up to the 
Rmpes folder. Click this link, and you1l be back up to the 
screen shot shown in Figure 2. Wdl explore link formats in the 
next sextion. 


Note also that you cannot link to the Notes folder itself, 
nor can you link outside the Notes folder You will sinipiy 
annoy the Notes Reader. 



5- The Halvah note, iiith a links to ^ravlax and the 
Recipes folder. 


Relative v. Absolute 

Just as you can with your web hies, you can rcfei- lo other 
notes using relative or absolute link piiUis, Note that / ivfcrs to the 
inside of Uie NfHes folder, so /Recipes/Halmth really refers to 
/NiNes/Recipes/Haivab. For example, here are some absolute links- 

<A HREF“file:///Cravlax>Link to /Gravlax (gn error)</A> 

<A HR£F“flie//Recipes/Uelvaii>Link te /Heclpea/lUlvah</A> 

<A HREF“/Graviax>Link to /Cravlux Can crror)</A> 

<A HSEF“/Recipee/aalvah>Link to /Recipes/iiaivah</A> 


l>ead Links 

Tlie Note Reader autoiiiatically checks every note for dead 
links. To see the results of this test, include an <ERRORS> tag in 
one your notes. The note containing tlic <ERRORS> tag is 
completely replaced with a list of all the errors found in all the 
notes, Tiiis means you only need one <f:rrORS> tag for your 
entire hierarchy. Use a testing note for this purpose, not a note 
containing useful content. Once youVe tested your notes, you 
can delete the error checking note. 

Figure 6 shows the results of a ctruple of puqxisely 
malformed links. Bad iPod, liad. 


r 


Rn Ideal Meal @19 



Link Error in file 
Notes^Redpes\ Ideal Meal. 
<A HREF=''HALVAHERRV at 
char:50.,:: 

Bad Jink, file not found. (5) i 


Link Error in file 

r*.Jriti»^;\Rprjnp‘s\ Idpal Mp.=3iI . 


Figtn^e 6 7?}e <HRRORS> fag at mirk. 


Here are some relative links: 


(A ilREF"filej//Graylax>Link to Gravlax (in ths current 
directory)</A> 

(A HREF-'flle://Recipes/Halvah>Link to Recipes/iialvah 
(only works if the Unking file is in the same 
dir sfl RGcipeR]</A> 

<A llREF“GravlaK>Link to Gravlax (In The current 
directory)</A> 

<A IiREF“^Recipes/Halvah>Liiik to Recipes/ltalvah, whore 

Recipes/ is in the current directnry</A> 


Link Files 

Just as you might use a file U> ncxlirect a user from one url 
to another, you can use a Jink file to rediretl a link and a Jinx 
file to spoof a folder of links. Here’s how this works. 

Create a Hie nametl pizza Jink ihai contains the following 

text: 

<TTTLE>Pizza Link</TITLE) 

CA FmEF="Real Pizza">Blap</A> 


Note that fde names are Ptol c'ase sensitive. Feel free to 
use- any of /, \, or: as a file delimiter, but remember that 
none of these are legal FAT file name characters and that 
i IS not legal in an HFS-t file name. Use a backslash to 
esc:ape special characters that arc part of the file name 
itself. For example: 

<UREF=“FerrBt recipes. 6\/23\/03-> 


Next, create a fde named Rmi IHzza with this text: 

Hey* l*iE the REAL pizza file. Not That other phony. My file 
name is Real Pizza, 

Put ilicm Ixjili in tlje sanie folder, somewhere inside the 

Notes hierarchy. When you scroll to that folder, you1i .see two 
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files listed, one nitmed Pizza link and one named Peal Pizza. 
Click on either one and die Real Pizza conieni is displayed. 
Since we never display the link inside pizzaMnk the text Blap 
never appc’ars. Hmiiim. Maybe this Is a gorxl place to pin your 
favorite Ixid words. 

Jink Hies let you store content in one file and refer to il 
from other directories. Can yon say alias? 

A .linx file Is similar, t>ut ii Is used to spoof a folder Here’s 
an example. Create a file named etnl.litLx widi this conicni: 

(TTTr.E>Kvll- Do Hoi Taunt</'nTLJi> 

<A HREP^’*doctDtrij/Dr. SardoTiacus“>Dr, Sardonacus</A> 

<A llKlit-”doctors/Doc Ock">Doc Gck</A> 

<A HREF="doetore/Br. Strangelove’'>Dr. Strange! ovc</A> 

<A HREF““doctors/Dr, No">Dr. No</A> 

<A HREF-Moctora/Dr. Rvir>Dr. Evil</A> 

Next, create a folder named doctors in die same folder as 
einl.tiruc. Finally, create note files named Dr. Sardonacus, Doc 
Ock, Dr. Strageioi^, Dr. No and, of aiitrsc, Dr FmI In the doctof^ 
folder. Figure 7 shows what hapjx^ns when you scroll to the 
folder named Hiil, Do Not Taunt. Notice that die notes listed in 
this directory are listed in die order we specified in the .linx file, 
not in alphabetical order. Hits can be useful! 



figure Z Beeti to the doctor lately? 


Main^linx 

When you navigate into the Notes folder, Notes Reader 
looks for a file named Main.linx in the Notes folder. If it finds 
MainJtnx, it uses tliat list to replace anything else in the Notes 
listing ii would nortruilly show. For example, iliis is a sample I 
created fttr die new^ Macintosh Art Museum Annex (MAMA), just 
south of Cupertino in Veerkidnya. 

<TITLE>Mac Huseuni</TITLE> 

<A tlRl^“"Art^Wonian in KiiBono">Ki®oiio</A> 

<A aREF-*'Art/CiaruE">Dog Cow</A> 

<A HREF-"Art/Zebra Lady->Zebra Lady</A> 
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Figure 8 shows what happens when I cWck tm ihe Notes 
folden Note that none of my other content is shown. Tlie only 
things listed are the links in MmnJinx. 



Figure 8. I be M£ie Museum, in all its ghry. 


For those of you playing at home, note that links in a .linx 
file are checked before they are listed. So if you are trying to 


follow along and you have trouble gening the links in your 
.linx file to appear, sure yoti've created the files referenced 
In the individual links. The example above won't work 
properly until 1 create the Art folder and the ihree files within 
that folder. Capisce? 


Worth a look: A new app named iPodNotes from 
XtremeMac along with a site named http://www.iPDdNotes.com. 
Pretty interesting. The app is designed to help you create 
and manage your iPod note projec:us. You am civate a new 
projea {essentially, a nott^s folder hierarchy), add files and 
foldeni, edit die files, and even aeate links to text and 
audio files. 

I he web site borrows from the iCal concept and allows 
yon to share your projects with other Folks. For 
example, my buddy David could upload his list of things 
he thinks I should do when 1 make that trek to Iceland 
I've been dreaming alHiui, along with notes for each 
item in the list. Or maybe someone would upload the 
Red Stripes touring schedule for the suTumer. Or liow 
atout if someone put together an audio tour of historic 
Civil War battlefields that you could download and take 
with you. Its all good. 

Tliough this puppy is still in it.s early .stages, I really like 
this concept. Check it out. 
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Worli^hop 


Qj Svsttffk Reqinremirnrt 
T ^ How to U« SiWnwhJJ 
Q SMpportea F«m#s 
▼ ^ Audio 

0 Il4bs and Jttbi* 


► O 

^ To Do iteflTts 
^ Tesung 
^ Feature Reqt 

► ^ Bug BeiMsnt 
^ ^ Code Snippy 


Easily create help systems for your software 
applications & web sites from a single source. 


SNEAK PREVIEW 

www.ebutterfly.com 


Save time with the integrated Workshop, TOC Builder, 
HTML Editor & Page Templates to quickly generate 
Apple Help, Web-based Help, UnlHetp, PDF & more. 


Tiii. Ni'Xi MoNiiL.. 

[maginc walking down the halls of the Louvre with an 
iPod in your hand, head.sets in place. You click on tlie Notes 
folder and .see a series of folders, each corresponding to one 
of the 9 main sections of the Louvre, Click on S£iiles des 
Feint tires, and you niighl find a list of ihe major works of art 
in that section, including the Mona lisa. Click on Mona Lisa 
and you might .see a textual description of the painting, 
along with an embedded link to an auclin file describing 
recent restoration projects related to the Mona Lisa. This 
model really touches on the power and potential of the 
Notes Reader. 

Next month, we’11 dig a little deeper into iPod Notes. Well 
see how to create links to audio files and how to work with 
Note Reader firererences. One of these preferences, 
NoiesOnly, puts your iPod into Mnseam Mode which causes 
your iPtxJ to boot right into Note Reader. Perfect for the 
Diuvre example alxwc. We'll also mess with some cool 
At)p]cScripts designed especially to help you tnanage your 
notes. Remember, if you are at WWDC, come say hello! See 
you then... © 
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Protecting your software and 
business revenue is simply a matter 
of choosing tiie right solution. 

HASP4'* gives you tougher, more reliable 
software protection than any hardware 
key on the market. With HASP4, you get: 

■ Hardware-based string encryption — 
the strongest way to secure your software. 

■ A true cross-platform solution: 

1 key for 1 source code for Windows* 

Mac 0S*and Linux? 

■ 99.97% hardware success” in the field, 
backed by ISO 9001:2000 certification. 

■ A time-based licensing solution with 
a real-time internal clock — ideal for con¬ 
trolled beta testing, subscription, rental, 
pay-per-use or any time-based need. 

■ The widest range of licensing, module 
and networking models available. 

■ 24/7 hassle-free remote license upgrades 
and advanced HASP reporting tools. 

Plus, HASP4 is so easy to use, you'll 
wonder why you didn’t choose it before. 

Open your eyes to real antl'plracy 
protection. Call 1-800-562-2543 or visit 
HASP.com to request your FREE personal 
HASP4 Developer’s Kit today. 


PROFESSIONAL SOFTWARE PROTECTION 


North America; 1-800-562-2543, 847-818-3800 or HASP.us@eAladdin.coin International: +972-3-636-2222 or HASP.il@eAladdin.com 
Germany: HASP.de@eAladdin.com UK; HASP.uk@eAladdin.com France: HASP.fr@eAladdin.com Benelux; HASP.nl@eAiaddin.com 


* Business Software AiIIa/Ke Global Software Pir&cy Studji. June 700?, ** Aladdin Knowledge Systems actual hardware key statistics; 1985-2002 
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UMTAMCLING 
THE WEB 


By Keinn Hemenway, Aloof Professumai 

The Lust for Control 


My love affair stalled belbre I knew love even existed. 

Coe Thi-: Grandiatheriy Biathfring 

r’ni not sure when exactly it began, or when I realized it for 
what it was, but my strongest memory is drawing a login screen 
for the iniquity BBS. This was probably my first attempt at a 
“server" - a collection of BBS floor games, Files, and ezines 
available under the name "T\w Darkened CU^sef*. Accessible 
only from the draconian hours of “wlien I got home from 
,sch<K)r to “when my mother got home From work", it was never 
the hit I imagined. Whenever I he^ir a Fear Factory all>unT this is 
what my mind returns to - the single-minded tweaking of an 
“animated'* ANSI menu. 

It certainly hadn't Ix^en my hrst attempt. After 1 suiv'ived 
learning MiLTopheme l.T and logging into local BBS's, I 
iinmedintely w^anted my ow n, anxious as heck to get I lennes, a 
Mac-only BBS soflw'are, operational. Through my own 
frustration of why I coukin't get .EXE files w'orking, 1 ran out, 
lx>ught a Windows 3/1 and DOS laptop from a shady pawn 
shop, and descended into the joys of qEdit, QKMM, TSRs, hiiich 
files, and more. 

My fond reminiscing of this lime wili l>ecome an imponant 
part of my biograpjjy. 

Thinking back, even before I rcralized a network existed, 1 
was interested in the aggregation of data. A big NFS player at the 
tinte, Ninteffcio Poavr regularly graced my Ixjokshelves and 
liciped empty my piggy l>ank. What was most annoying, ihough, 
was having to find that one tip \ needed to suivive, that one 
cheat code that strayed frtim the Konami norm. HiHing frantiailly 
wliile the game was paused just didn't satisfy my Ixiyi.sh 
impatience. 

! needed a database, and thus beget my first pathetic 
a Item pi: a giant text file on a Brother word prex^essor. I 
rememlx^r sitting in front of that 7,000-pound Ixi'liemath and 
transcribing, wwd for wortl, the tips, tricks, and ccxle sedions of 
all the Ixick issues I could find. Copyright meant nothing to my 
excessively star-filled eyes,.. I was gonna bet'ome an even better 
player (through chequing), and gosh darn it, my electronic 
Brother was going \o help me! 


My desire for collected data and my own server only 
increased witli time. 

The lust for conirt}! continued with Uk* creation of my first 
web site back in early 1997. Enhanced by that magical tilde, it 
was a stunning portrayal of all the sites we've come to hate today 
- an intro page with three glowing buttons (I too loved the 
Adolie filters) and very little conteni. It was also the first battle 
wound of aliempicd (luk! failed) self-imposed censorship: my 
ezine, Devil Shat, got me kicked off' AOl. sfiortly after die fourth 
issue. I needed a web site for my mi.ssives and I got it ail wrong, 
much like the Broilier dalab... er, text file. 

It didn't matlcT, t>f course. Perse%^enince just doesn't quit. 

Months after my alxjited A-morbus/ aUenipt, I decided I 
needed to start over fresh, and purchased disobey.com as my new 
beachliL^ad of world domination. It did well as a cultural haven, 
and my continued and ner\'ous explonuton of Linux, combined 
w'itli timing that only fate could prcxJuce, landed me a job at my 
local ISP. It w'as perf'ecl - ntU only did 1 control my own web site, 
blit now had control of the very web server it resided on! My BBS 
and data dreams were enfiamed, getting firightcr as my love of 
Perl deepened - not only ctHjk! I tw^eak what Apache did, hut I 
could iwTak what Apache served, dipping into MySQL tiatalyascs 
via a CGI script of my own debasing. I felt like I had lieen handed 
a gift - the realization that everything I had dreamt of doing 
could Ix" <lone, auci il iimrPt that bard. 

Enter Mac OS X, Mark, And Unwi-lcome Innuendo 

When Mac OS X was released, it blew my mind. Here 
was my beloved Macintosh GUI, with whom I had coded 
countless Perl scripts and uploaded numerous buggy 
attempts, suddenly silling tm top of every tool I used at the 
ISF^ Apache, Sendmaii, Perl, a shell! J was in ficaven, and 
steadily watched my productivity incrca.se tenfold. No more 
did I have to debug my scripts fnaii afar - duplicating 
disobey.com's .Apache configuration under OS X was 
iiiimediate, as was my satisfaction, h was one of diose 
moments where part of the equation disappeared: no longer 
did I need two btixes, a Mac for getting w'ork done and Linux 
for gelling work public. Everything old was new again, a 


Kevin Hemenway, coauthor of Mac OS X Hacks^ is Ixftter known a.s Iff, the creator of disobey.com, which bills itself a.s ‘‘contcTil for the 

di.wontented.’' Pohlisl^er und developer of more home cXKjking than you anjld ever imagine (like the popular opcn-souretxl aggrejgator Aniplietaltek, 
the best-kept gaming secret Gamegrene.com, articles fix Apple’s Internet IX'veloper and the O'Reilly Network, etc.), he's an ardent .suppcjiter of 
downloading his brain into the compuier anti living forever. Contact him at morbus@dtSObey.com. 
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stay In Control Wherever You Go. 



Now, both of these indispensable tools 
are updated to take full advantage of the 
world's most advanced operating system. 


Mac OS X Ready 


For more than a decade, Timbuktu Pro and netOctopus 
have been the leading remote control, file transfer and 
systems administration applications for the Mac OS. 


Here 



Windows XP Ready 


Timbuktu Pro 

Whether you're at home or at work, Timbuktu Pro allows you to operate distant 
computers as if you were sitting in front of them, transfer files or folders quickly 
and easily, and communicate by instant message, text chat, or voice intercom. 

http://www.timbuktupro,com 


netOctopus 

Intuitive and powerful, netOctopus can manage a network of ten or 10,000 
computers. Inventory computers, software and devices on your network; distribute 
software; configure remote computers; and create custom reports on the fly. 
http://www.netoctopus.com 

Learn more, try it, or buy it online. Call us at l-800*485-5741. 
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sentiment ech<>cd by a very 1 ike-minclccl Scort Knaster 
(MacTecb Magazine, April 2003)^ 

Shortly after, my Apaehc articles for O'Reillys 
MacDcvCenter.com apfx:arcd. A soft introduction to senaog web 
sites with OS X's Apache, they were very well received, enough 
so that I went on to co-auShor O'Reilly's Mac OS X Hacks. 
Currently in the pnxiess of l^ing re-edited and reprinted for 
Jaguar on http://m3cdevcenter.com/, my original articles aroused the 
aitention MacTecb editor Dave Mark. 

Uis email had me at "My name is Dave Mark'', really, but 
the rest of liis cranium-enlarging fan gushing sent me over the 
edge of acceptance. Yes, Td !>e interested in writing for 
MacTecb. Yes, Vm really as handsome as my O'Reilly photo 
professes me to be. Yes, if you give me a column, I’ll let you 
hear my inij>ression of Barry White. Yes, yes. Yes. 

With a license to write alxjui anything having to do with 
the web: opinion, programming, config, Perl, firewalls. 
Anything." I couSdn't pass it up. Witliin a week of our initial 
contact, I settled on the following introduction: 'Mmt spider 
twhs conmin elegant symmeify\ layer upan layer of silk ami 
IH>l)fg(mal heaiilyK Some, botawn create chaotic nmnes with no 
apimrent rhyme, reman, or pattern. For those who'm newr 
delmi into setting up their oam ueh seuKr or ctKling their own 
weh scripts, this ^'tangled Web" of confusing acronyms, daetnons, 
and protocols is ettongh to make sucking blood a mahle career 
change. With MacTech’s ''(JniangHng the Web" senes, ae ll 
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^ ► HotSync’ 

HoiSync to Mac OS X/9 

^ ► Memory Stick™ 

Desktop Mounting on Mac OS 

► ITunes™ 

Use.; Your CLiS ^ 

► i Photo™ 
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• MEssIng Sync for Palm OSE 
! Missing Sync for Samsung iSSO! 


Cariy Aiiapt&i: Vernon Now /iv* 


The Missirtg Syhe for Pocket; PC! 


I at WWOC In San jose, CA June 23 - 27, 2DD3 for Early Adopter VereEon detaFt: 


www.markspace.com 


alleimte your Stomach knots with a guide to turning ymtr OS X 
machine into a iieb serving and iveh pnygramming ponsirhonse. 
Free thase hiiUerJliesr 

Entwined metaphors leave me in stitches. 

In Which Mr, Earbrass Finishes Chapter vn 

A web column b a natunil progres-sion for MacTech - the 
past four issues of our 19^^^ year included Dan W(xk!'s “Building 
the fniemei-Connectetl Af)[>itcai!on” {MacTech, January^ 2003) 
and Fritz Anderson's three-part “The Web from Cocoa" 
{MacTecb, Febnmry, March, April2003). If your appllattion isn't 
web-enahled somehow, ytju may think you’re falling Ix^hind. 
While we won’t l>e focusing on die Cocoa or Olijcciive C end of 
your app, we’ll defmitively cover the other half: making your 
application's imb site smarter. 

With a comically wide creative swath, I'll cover tlie “l>asics" 
first: enabling the Apache web server built into your OS X 
machine, turning on its features and learning how to use them, 
as well as how to play with technologies like SOAP, XML-RTC, 
and the hosts that provide public APIs. 

You may have noticed ihai “Ixisic" is quoted - tliere's a reason 
for this, Urgely, most Apache tutorials are just that - they tiiior you 
in ihe Ixisics enough to get you going and then send you out into 
the world. Thafd be fine if my audience was .stimeone who just 
\vanted to hast a weblog, but I’m of the mind that we're all a little 
[lit smaner than that, and we w^tnt to do something ^reai" (ntH The 
Real Cancun real, but rt.*:il nonetheless), HI tnagnanimously 
attempt to give you the frt‘e lovin' you yeatii fur. 

Once w'e have our own web server running struKHhly, I'll 
meanrler a bit alKmt pfe-[>ackaged sofrw”ire. T(K) tnany fjeople 
teach Apache as a ukjI for the outside w'orld and totally ignore 
its potential as a supplementary local tool. Much like we may 
use iPhoto to organize our pictures, there's much to Ix^ gained 
l>y using a wxdi-based script likt^ Gallery. And even tliough the 
recently released iTuncs 4 can stjeam tracks over the w'eb or 
Rendezvous, using Andromeda will allow your Windows and 
Linux friends lu jam along w'iih you, 

Famuxarity That Breed.s An 1Jh-Oh! 

Ctx)l ITRLs never die. 

Or, more accurately, lliey ficver change. And that’s the 
first retimically inclined concept 1 want to leave you with. 
Miicii like most accidenis happen within a ittile of ilie home 
(a statistic I've always had a cliuckle over), LlRLs are so 
familiar that we don't really think of them as someifling that 
deserves a seex^nd thought. Unfortiinaiety, thaps an invitation 
to a little party wrecker called the 404 - the dreaded "Noi 
Pound" error tliat permeates our .search results or carefully 
(j rga n ized I K>k ma rk s. 

The groundings in iMl design can he found in the World 
Wide Web Consortium's (W3C) “Style Guide for online 
hypertext", which contains a document From 1998 entitled 
URls Never Die" (the difTerenre between ‘"IJRl" and “URL" aren't 
important for now). >VnLd do yourself some gtxxl to familiarize 
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Draw Make Drawing Fun on os X 

Introducing EazyDraw - the fun, easy-to-use Mac OS X design tool that lets you draw 
like a pro! Now you don't need to be a graphic artist to create great illustrations. 
EazyDraw's vector-based graphics and editing capabilities make it easy to create 
technical diagrams, flow charts, and business communications as well as commercial 
line art illustrations and graphic elements for application software and web design. 

Learn more about EazyDraw today! Get big savings buying direct from our online store. 
Visit us at vwww.eazy draw.com (That's easy with a Z). 
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yourself with this body of work, as well as the matching 
Aleitt>t>x coiurrm frtnri Jakob Nielsen (linked from the ^'Ccx)! 
UMls" anide): 

http://www.w3.org/Provider/Style/ 

Hie larger points can he Ixiiled down, simply, to: 

Your IJRLs Should Never Chajij;e: In orher words* once yon 
make a URL pnl^lie, it should rcanain acccs,sil>le for liie rest 
of forever, which most people suspect is a veiy long time. If 
yon absolutely MUST change the legation of a resource on 
your web site, you should have ihe original URL point or 
redirect to the new^ location. 

Your URl^ Should Not Reveal Your Techuical Capabilitiest 

You may i>c using HTML today, bin ten years from new 
when you'll be fiddling with XHTML, any URL ending witli 
.html are visually and technically inaccurate. And what 
about that /cgi-bin/script.pl of yours? What happens when you 
switcii to Flip, Rul>y, or Pytlion? Your URLs should never 
have an identifying extension (like .html, cgi, or .php) nor 
should they contain an indication of their backend (/scripts/, 
/cgi-bin/, /database/, cicj. 

Don’t Be Specific; Try not to include titles, authors, status, or 
any other fluctuating bits of infonnanon in your URL: 
morbus_i 0 tteLhtml, draft-pr.php, and my_favorite_musrc.txt could 
all be improved (the great debate, of course, is how to do 
so), 'Ibis IS the trickiest part of creating a good URL. 

Llmcrot is Tiili Devu.- Are you a frieivd of the De\tl? 

As the column progresses, well keej^ the alxive tenets in tlie 
Ixick of our minds - I'U show you how to remove the need for URL 
file cxicnskjns, how lo turn on spelling cormetinn so that fumbling 
fingers follow the facts, and how' to redireel uasjglilly JOTs U> their 
proper kx^ations. We ll also examine a few tricks on how^ to Ixf 
f)n>aciive alK)ui yours, and others, inevitable mistakes. 

Now, as a slight precur,st>r to the inevitable Nelson email, 
some of my own imsling sites doift follow all the .suggestions 
ril give. 1 t“an (and do) fix every 404 I Ve ever created, but other 
tricks require forethouglil that I jusl didn’t have when these sites 
were originally createcL S<une suggestions, like exlen.sion-less 
files, can often have a detrimental effect to caching servers, 
esf>ecia]ly when Fve Ixi^en using /about/morbus.shtml for the past 
four years, and then suddenly change to the ,stronger 
/about/morbus (likewise wath the often imerchangeuble 
www.disob6y.com or disobeycom)* 

If you're redesigning your web site, sianirig fresh, or 
planning on launching a new sub-section, give special 
consideraticai lo ihe suggestions above and in the URLs feaaired 
- you have the chance lo do things “right” {or, at the very least, 
'‘better”), and that’s not an op|x>rtunity you siiould pass up. 

But First, The Wh()r„- ISPs! 

As with most Maeintosli technologies, you may l>e surprised 
by how easy it is to turn on your builtrin Apache wel> server, A 


click of a button here, a browser location there, and you should 
be serving with the best of ‘em^ right? Well, maybe. Sorts. 
Perhaps. Ok, look, it really depends on your Internet connection. 
If youVe got a dial-up connection, then you've got nary a wony, 
DSL or obie users, however, it’s a different matter entirely. 

See, with a dial-up connection, nothing fancy really 
happens. You dial into your ISP, get assigned a dynamic IP 
address (see Figure 1), and that’s about it. 'there's nothing 
funny with routers, DHCP, NAT, or acceptable usage policies. 1 
mean, who'd be crazy enough to seriously run a web server on 
a diai-up modem anyways? 



figure fX^iennming yw^r eikii-jtp fPmidn^ss. 


With always-i)n home connections, like DSL and cal^le, the 
issues start sprouting up left and right. Your first hurdle isn't 
even tedmieal in nature: unbeknown.st to you, you probably 
agreed, on .sign-up, to never ivn a seiver of any kind, l>e it web, 
FTP, Direct Connect, or whatever. Legally, this puts an 
immediate dent in your web serving dreams, and thus, should 
be tlie first issue you get out of the way. Check your provider’s 
web site for an “Acceprable Use Policy”, “Usage lerm-S”, 
“Suhsenber Agreement, or some other freedom-limiting 
statemetit of fact. For Qjiiicasi, a New England cable provider, 
we see only frowms: 

""Wbeiber Ihe cable modem is owned by you or us, u^e have 
the unresincted right, hut not the ohligation, to upgrade 
or change tbc/innware in the cable modernt at any 
ibal ae, in our sole dticretion, determine is necessary or 
desircthie.'* Section 1(a). 

Section Kb) allows Comcast to enter you r preni ises... at a 
time agreed to with mP to mainiain liteir eqiiipmenu 
but that 1 **agree lo indemnify, defemd and hold 
harmless Comcast and its ajfiliates and agents agaimt 
all claims ami exfjenses (mcluding reasonable attormy 
fees) aming ottl of any breach of ibis fsectionl** l\v a 
nagging paranoia this means they can break into my 
house without legal repercussitms, 

“Sy iLslng the Service to puhiLsh, irammit or distribuie 
material or contmi, ymi consent to and authorize 
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C<mu4si, its agents and aJJHiates to reproduce, puhlisb, 
distribute, and display the content myHdmde,.,*' In 
other words, the tlrorte from Sec tor IG is (xxsiing your 
love letters neiir the water cooler. Section 2(c). 

Since these columas deal with the weij, how^ever, let’s stay 
on topic: 

.. The Sennee is for persomi and mm-commercial use only 
andyott agree myt to nm the Sennee for operation as an 
tniemei sewice provider, a server site for ftp, telnet, 
rkfgin, e-mail hosting, *ii)eh hosting'^ or other similar 
applications, for any hiLsiness enteiprise, or as an end¬ 
point on a non-Comcast local area network or tvide 
area neltmrk." Section S(a). 

^"Comcast will provide you with dynamic Internet protocol 
(W) addressfifs) as a comfxment of the Sendee and 
these IP addressfes) can and do change over time. You 
will not alter, modify, or tamper with these dynamic IP 
addressies) or thtm^ of any other customer. You agree 
not to use a ilynamk domain name server or DNS to 
associate a host name untb the dynamic IP address(es) 
for any commercial purlnmf." Section 6(D. 

You may find similar iitmts in your own provider's usage 
|xJicies - they really want you to pay for hosting with them, not 


set out on your own. If restrictions exist, you're left witli only 
three options: you could find a new and friendlier provider, l^eg 
with your current one to hMmm their IkHis, or liojx; they don't 
catch you wrhen you inntHcntly “forget". 

Where Are You LtxATED On The Cckt? 

If you're shopping around for new coiinectivity because of 
a restrictive }X)licy, iiere's a quick run-down of what youil need: 
a static IP (ie. one that doesn't change, like a dynamic address), 
a fast connection (DSL or higher), and no restrictions on hosting 
your own servers, Ix^ tliey tnail, web, etc. You may also 
want to find out acldiriojial chargers ft)r exceeding allowed 
bancKvidth - if your site gets SlasI idol ted, you don't w ant y our 
prtivider turning you off midway through. Likewise, find out 
their uptime, support policies, how long theyVe been in 
business, who their upstream is, and .so forth. Having watched a 
friend change DSL providers three times in one year, two of 
w^hich c:losed up shop with only weeks notice, stresses how 
much of an important decision this Is. 

If yoii're not c:hanging providers, either due to liappiness or 
memory kxss, dicre are a few other technicalities to worry about. 
First and again, you really should have a static IP ^ if you don't, 
you may end up having to u.se a dynamic DNS service like 
dyndns.org. These services assign you a domain name that 
fbilows you regardless of your IP address, which is reported 
back to their servers by software you install and run continually. 







UML Design Made Easy for Mac OS X 

% t J s*: Dtfsijriptiurts w iih TraceabS I it>' 

# C lass M odcis ^t^4 Packagic I} i ajiram s 

# Sequence Style Ohjecl Models 

# Integrated Project Dictionary 
9 Integrated Ctxle Files 

# Coding Spccitlcations 

9 Verillcaiion and Batancing Reports 
9 Namespaces To Partition Complex Project 
9 Export Diagrams To Popular Image Formats 




Mac OS Linux or Windows. 

— A 


,$495 



QuickUML 


I <i««lckUML 


ex:g#i software 

www.excelsoftware.com 
Ph.505-771-3719 
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You can use (>nc of their 30+ vanity addre^es or your own 
custom domain if you already have one. 

Next, find your external IF address, that is, the t>ne tliat’s 
accessible to the oumide workl 'file most reliable way to do this 
is have someone else tell you, so you should run off to 
http://checkip.dynclns.org/ (Figure 2) and write down what they 
say. Don't take this as face value just yet thougli - Ix^fore you 
trust tlus setting IOO^j, shut off your cable or DSL modem and 
wait five minutes or so. Turn it on, go back to that page, and see 
if the IPs are the same. If they Ye not, tlien youVe got a dynamic 
IF that changes ut)on each connection to your service (which, 
by nature, is far less often than a dial-Uf)) - you1l have to keep 
this in mind during power outages, service interruptions, or 
whenever you relxKH your equipment. 


0 0 _ V90 USB Fa xmi^rieni_ 

Con rat ion: Zoom V90 USB Faxmodem _^ Q 

Status: CMintctcd lo 173. ISfi.63.16 k Sliil bps 


Conrted Time OJlOISI 

iPAdd/eii 63.175 


( Dittonntci '' 


Figure 2. Your exiernal IP address, as re/XHted by dyndm.orfi. 


hisrh quality - com^i^citiva rates - 16 years experience - award winning 


Full Spectrum Software 

Development & Testing 

Device Drivers 
Porting Plug-Ins 

TCP/IP 

Carbon / OSX 

Cross Platform Development 


One Bridge Street 
Newton. MA 02458 

6I7-96S.0029 

w¥fw*FullSpectrumSoftwarexom 


competitive rate* - 16 years experience - award winning - high quality 


In practice, wc'rc still not entirely hojue free.., your ISF or 
local network configuration may also contain a proverbial 
wrent^h. Paradoxically, .some of these you may not know exist 
until we actually lum on the web server and start fiddling with 
serving pages. We'll get to that in the next column, hut for now, 
nio through the list l>clow and find out as much as you can: 

Does your ISP use DHCP? If so, you may have a DHCP kme 
on your IF address. Depending on your ISP, these leases 
ccRild expire every half hour, every month, every year, or 
whenever, after whicit, youU auiomaiically aiceive a new IF 
if this is the case, you may, dejx:nding on tlie dumtton, need 
some son of dynamic DNS service to follow your IP address 
as it changes. 

Do you, or someone you love, use NAT? If you've multiple 
machines in your local network, your router probably lias an 
external and inlernal network interface - you'll need to read 
your routers instruction manual to forw-ard all incoming 
traffic on the externa! interface to your internal machines. At 
tile very least, HTFP traffic needs to Ix* forwarded to the 
machine you'll Ik^ ninning the web server from. 

Does your ISP filter incoiiihig traffic? Some ISPs, eillier 
het:ause they think they'll lose money from web hosting, or 
they’re trying to stop the pioltferarion of vinises like Code 
Ked, will filter all incoming HTTP \xm traffic. If this is the 
case, yoiYIl have to configure your Apaclie server to listen on 
a non-siandartl ptjil (like 8080). Likewise, your URLs will 
need to contain tliis different port inibrmaiion. 

Do you or your ISP liave a firewall? OS X is pre-configured to 
allow incoming ITri'P traffic on pon 80, but other firewalls 
(eiliier installed on your well server, or part of your existing 
network) will block all but a small subset of incoming Lraffic. 
Be sure to check that port 80 Is allowed with no restrictioas, 

vSome of the alx>ve problems can l)c solved iniemally with 
your Apache configuration, and well get to those' relevant 
changes in future columns. Otlter solution.s, however, depend on 
your netwwk and ISP's configuration - Llie.se t'ase-by-case 
scenario.s exist solely in yt)ur own dreamland, and thus, this 
Nemo can't offer as^sisumce. 

Ho.mhwork Mai.ignment.s 

Students may contact the teacher at morbus@disobey.eom. 

Read the W3Cs '’Style Guide” and the siipplemeniuiy AlerilK>x 
column. 

Up, Up, Down... complete the axle! 

Finding out who ‘‘Mr latrhniss" is is easy, but why is Chapter Vll 
significant? 

"Tlie inevitable Nelson email* - huh? 

'ilirow another one-iiner on the pile. 

I panially quote from a TV show. Which show? 
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J^hinkfree^ 


TliirikfreeOffice 

COMPATfBlI WtTH MICROSOFT WORD, EXCEL AND POWERPOINT 
WORDPROCESSOR • SPREADSHEET • PRESENTATION GRAPHICS 

The Affordable Office Alternative! 



Macworld 

♦ w I 


“T hinWf^ is a 
bsst-or-brwd pfogitwn 
Uut will exc^ad your 
expactstions* 

— J^fhfy&mmshy 


MacAdcflct RATED 

ooooo 


GREAT 


^linkfrao OfTioa is the 
n«xt beM thing and 
then some * 

** OsibomirT ShadoviU 


“Thinktren DMictn ka an 
Impressive attempt to 
crack the seemingly 
impenetrable 
productivity market,* 

- Cht^ Wflrrf 
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i^le Stoic 

Aopt© Soeoialisl 

■SHKSBI 

l^il'acuecrrRonics 






Three High-Performance Applications 


Thinkfree Write 

Thinkfree Write is a powerFul word processing application 
tliat enables you to create rich, proFessional quality 
documents and Web pages. You con insert tables, 
images, and clipart, or even apply custom layouts to 
your document,.,then effortlessly proofread your work 
with the easy-to-use spelling and autcKorrection features. 

Thinkfree Calc 

Thinkfree Cote is a full-featufed, easy-tcHJse spreadsheet 
application that can easily tackle the most complex 
analytical tasks with over 40 charts and 300 function 
capabilities. Thinkfree Calc opens, edits, and saves 
directly into the Microsoft Excel (.xls) format, so users 
can seamlessly share documents and colloborate with 
Microsoft Office users. 

Thinkfree Show 

Thinkfree Show enobles you to creote high-impact 
presentations including animation effects, drawings, 
images, clipart, and other graphic features. Thinkfree 
Show opens, edits and saves directly into the Microsoft 
PowerPoint (.ppt) format. 

CyberdrivePlus 

A tree, one-yeor subscription to CyberdrivePlus is also 
included. CyberdrivePlus provides you with secure, 
Internet file storage and free online software upgrades] 

ONLY 
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SECTION 7 


By Rich Morin 

File Mode Idioms 


Which modes are used for what? 


fiilch Mile OS X file system ncxle has a 16-bit imxlc word, as 
dcscrilxrd in chmod(1,2) and stat{2). lliLs word spedhes the 
ntxle’s type, w'hat access modes are allowetl, anti some 
specialized handling. 16 bits provides 64 K |K>ssif>je v^ariaUons, 
hut only a relatively small number of ^file mexie idioms** are 
found with any fret|uency. By learning some of these idioms, 
you can make your systent more secure and undeistand existing 
configuration decisions, 

Fijj- Tvpfj> and Mdd&s 

Before we get into the idioms^ however, let's review l!ie 
biisit:s of file types and mcxles. The file system recognizes many 
types of “files", induding a number of ihings (e,g., directories) 
that aren't really files, at all. The most common file type, 
however, is the “regular file”, followed by the Mlrectory" and the 
“synilx)lic link" (aka symlink{7)). 

There are dozens of device files (M.-e mknod( 1,2,8) for 
deiails), hut they are almost always segregated into ilie /dev 
direcujry. Sockets and named pipes can be used to enable 
interprtxess cuiiim unicat ion IxiW'cen arl>iirary prexesses (see 
mkfifo{2) for details). Finally, the “wliiteout” lypv is used lor liie 
(ever-cx]xrrimental) Union File System, descrif^ed in FreeBSD's 
mount_unjon(8) man page. 

'llie nrxle's type Is specified by the to]> four bits in the mtxle 
word, available via the stat(2) system call: 

0160000 whiteout 

0140000 socket 

0120000 symbol U U»k 

OlOOOOO rc'gLilat file 

0060000 block special device 

0040000 directory 

0020000 charflcter special device 

0010000 nained pipe (fifo) 

'llie next three bits six'cify some forms nf “special 
handling". If the node is a regular file, the bits are inteqireted 
as follows: 

0004000 set user id an execution 
0002000 set group id on execution 
OOOIOOO save swapped text, even alter use 


Tile first two bits are described in the setuid(2) man page. 
Briefly, they allow a program to run with the permissions of its 
owner (or group), rather than thase of the user who started it. 
This is uj^^tl to provide controlled access to elevated privileges in 
(carefully constructed!) system ct>mmands. 

You can get a list of your sysienfs setuid and setgtd 
commands with the following C-shell command (use whereis{1) 
or whtch(l) 10 find tiie lull path name of a specific command). 
In the output below, df is setgid to 'operator'’ and rep Ls setuid 
to “roof: 

% Is 1 /Lusr/I L */n *Blbin | gr^p ♦[r ] - s^ 
r xr sr X 1 root opiitatot ... df 
r-sr xr-x 1 root wheel ... rep 


4'he third bit, descrilied in sticky(8), tells the system to retain 
ihe read-only parrs of a program's image in memory, after the 
program has tcrminaled. This can be used to reduce the start-up 
time for frequently-run programs. Wlieiher your OS honors the 
request is, of course, up to the vendor (:-).’ 

[f the ncxle is a directory and the .s'ystern is SysV-ish (e g., 
Kcd Hat Linux), tlie setgid bit may lx interpreted as forcing 
“BSDish” i>ehavior in setting the group for a new fde. Tliat is, a 
new^ file will get ihe enckxsing directory's group, rather than the 
users. On BSDish systems (e.g., OSX), tills liit has no effect. 

Sticky direciories am a bit moi'e comi^iex^ Ix^re's a snippet from 
tile manual: “A file in a sticky directtiry may only Ix^ removed or 
a^named by a u.ser if the usct lias write fxmiission for the direclory 
and tlie user is die owner of the file, tlie owner of ilie directory, or 
the super-user. TliLs fealua is u.sefully ajiplied to direaories such as 
/tmp. which must lx [XihJiciy writable but should deny users the 
licen.se to aiBitrarily delete or rename each others’ tiles.” 

Tlie bottom nine bits are divided into three sets of 
permissions (for the file's owner, members of the filers group, 
and everyone else); each set .sfsecifies read, write, and 
execute permission: 

ODD040n read permiaaton, dwticr 
{10OO2CIO write permissioti, owner 
OODOlOO execute/search permission, owner 

0000040 tGad permission, jiroup 


Ricli Morin iias Ixen using computers since 1970, Unix since 19H3, and Mac-liased Unix since 19B6 (when he heifietl Apfile cmate A/LTX 1.0). When 
he isn't writing this column, Rich mns Prime Time Freeware (www.ptf.COm), a publislier of books and Cl>ROMs for the Free and Open Source software 
community. Feel free to write to Rich at rdm@ptf.COm. 
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The meanings of read, wriie, and execute are a hit strained, 
when it comes io directories. Read permissicjn allows die user to 
“read" die directory. Itxiking lor file names, etc. Wiiie permission 
allows the user to “write" the directory, creating or removing 
file-S, etc. Hinnify. execute permission allows the user lo access 
an item contained within die directory, 

Fiijf. Idioms 

Most files am reiidalile and writable by tlieir owTiers. If 
noixxiy else Is exfiected to access the file, no other pemils,sions are 
needed, i lowever, it is coninion to allow group acces,s, as well: 

X touch 0600 0660 
% chmod 0600 D600 
% chmod 0660 0660 
% Is -1 0* 

rw-0600 
-rw-rw- ... 0660 

Obviously, executable files need to have the appn>]matc 
“execaite" bits set. Irss obvkjusly, die “read” bit must \y^ set for 
scTipts (so tile interpreter am read them!). In pntciice, even 
binary executables tend to have read access turned on; for one 
thing, this allows deliuggers to iasjiect the binary. 

Distributed executables often have write access turnetl oil 
This seems like a good idea, liec'ause it rctduces the cfiance of 
inappropriate mcxlific^ation. An inspection of /usr/bln on my OSX 
system, however, show.s that this praedee isn't universal; 

*rwxr-Kr-x ... cscope 
^r^xr-xt-x ... ctags 

System-wide fdes, such as the executables in bin directories, 
generally need to lie acmssihle by everyone on die system. 
Many system control files also need universal read access: 

-r--r--r-- /etc/ccantab 

sudo{8) allows any command lo be am as if by any 
specified user, assuming that the actual user can supply the 
required password. Llnfortumitely, this requires passwords lo l)e 
handed out, rcmemlicred, guarded, etc. Fortunately, the file 
system provides an elegant solution: 

-rvsrx--- 1 tgsT wheel so 

The “SO” command (at least our version :-) gives root 
privileges to anyone who is in group wheel. Jf argumenis arc 
given, they are nin as a command line; oiherwise, the user is 
given a r<H7t-c‘naliled shell 

DiRFxn^oRy Iduims 

Tlic mode bits for home directories should keep each 
users files safe from casual inspection (ler alone mcxlifit^atlon). 
Depending on the environment, and your own level of paranoia, 
one of the following is probably appropriate: 


drwx-'---* ... abc ^rpl 

drwx--x--- def jtrp2 

drwxr-x-*- ... ghi grp3 ... 

drwxrx-x ... jkl grp^ 

drwxr xr x ,.. mno grp^ ... 


User abc doesn't want anyone else doing anything with 
his files. User del Ls willing to let memlicrs of group grp2 acce,s.s 
files, hut only if they know tlic file's name (reint)ving read access 
from dirccu>rics turns off Is access, wild cards, etc.). User ghi 
seems to trust his group fiiirly well but stiU doesn't want them 
neating files in his home directory'. 

I Isers jkl and mno trust everyone on their computer as much 
as users def and ghl trust memliers of their groui’is. Because security 
lends to he antithetical to amvenience, luser ghi [ia,s ihe Icusi 
pmblems sharing files, etc. For what it's worth, 1 use mnos mode 
on tny deskioj) machine and jkfs mcxle on my server account. 

Allowing directory execute access by others c:an lx: t|uite 
useful. Lets say chai ycni wan! to set up a “drop box” where 
other users am leave files. Anyone should be able to drop stuff 
off, but only you should be able to kxik into the Ixix, retrieve 
files, or (gasp!) remove files. Here'.s how: 

% chfiDd 1711 drop^box 
% Is d drop_box 
drwxwx'wt ... drop_bo* 

As the owner, 1 am allowed to do anything to the direciory . 
Others (including memlx^rs t>f my grtnip) are allowed to access 
and even create files in the directory, but they are not allowed 
lo ILst its contents. Finally, the “sticky” bit (descrilxxl alx>ve), 
keeps anyone but me from reniimn^ files from the directory. 

1 encourage you to set up a “icstlx^r dircciory and tr>^ out 
different modes witliia it. Try out different combinations to see 
how they might be useful; all of this will pay off .stime day wlicn 
you're trying to figure out an ot>.scure "file nt)t found” or 
"permis.Hion denied” error niessiige! 
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Expertise In... 

QuickTime 
Cocoa 
Carbon 
Mac OS X 
Web Services 

digital prairie systems, inc. 

With over 15 years of Apple technology development 
experience, Digital Prairie Systems. Inc. offers a wide 
variety of expertise for your Macintosh development 
solutions. 

www.theprairie.coiri 

6545 West Central Avenue. Suite 203. Toledo, Ohio 43617 
419-843-6127 x101 . solutions@theprairie.com 


June 2003 • MacTech 


Fiu! Mode Idioms 


23 









EMERCiniG 

TECHNOLOGY 


By Vicki Brown 

Distributing the Future 


The O’ReiUy Etech 2003 Conference 


"Ihe hiture is here; its jmt ml eirndy liisirihtmdyet 
- William Gihsim 


Innovation Showcase 

If asked u> say what 0‘Kcilly Ik Assottaies most 

jX'ople would probably uaswer that they publish lK>oks and run 
leohninil conferenres. If pies-sed for more^ some miglit add that 
tlic conif^any perfornis market research, iet*hnoloj*y atlvocacy, 
and technok)gy incubation. Tim O’Reilly, founiler and president 
of O'Reiliy & AsstKiaies, sees the company's goal as st>niething 
mudi broiiden “dunging the world by rapturing the knowledge 
of innovalcjrs". 

To acliieve this goal, O'Reilly must lie cottstanlly on the 
w'alch for innfwation, finding new, transformative technologies 
that they can catalyze. Tiiey accomplish this by: 

• Knowing what’s ccxil and important and evangelizing it 

• Recognizing “alpha geeks’’ (techies that are eonsistenlly 
alieatl 4)f the curve) and leveraging their ex|x:nise 

• Reducing the learning eur\^e and enhancing the depili 
and quality of infomiation alxiut new technologiejs 

• Listening to and Sjxaking uj> for the interests of tjser anil 
develo[X*r communities 

• IJnjkering dialogue Ixtwet'n comixhtors in the interest of 
open standards 

• Kxercising common sense 

Tim is an avid follower of technology and Leclinologists. He 
continually set^ks out interesting people and ideus^ then works 
to “amplify iheir effectiveness liy spreatling the information 
needed for others to follow tliem’'. One place where much of the 
newest, coolest, most transfontulive teelmology is showcased is 
the annual O’Reilly Emerging Technology Conference 
(htlp://c0nfefences.of€ilfy.cotri/etcon). 

!n his conference session enlitled The O'Reilly Rmhr, 
Tim explained the philosophy outlined above and argued 


that the most interesting emerging technologies mecL the 
following criteria: 

• the technologies are “disnipiive”; disruptive technologies 
cause changes to the way we think and work 

• their uptake tailoption) is accelerating 

• they have grassr<K)is (lK>itom-tip) sup[x)fl; support from a 
few large institutions is less important than sujiport by the 
larger developer and user comniimilies 

• tfiere's a real need for inlbrmatifin 

• the technokigies Imve firofessional practitioners (with 
real-world applications) 

• they provide a possible business ec^ology 

• they liave deeper social iniplicaiions 

• they inspire passion 

For llie allendt'cs, organizers, and presenters at O’Reilly's 
Bmerging Technology Conference, the future is definitely 
here. For one week in April, Ftech 2{)()3 distributed some of 
I hut future* * 

Day One 

The first talk I uitended, entitled lUuh^kiii Computing, was 
presented by Eric Bonabc^au of kawyslein Corporation* The 
content of the presentation wasn’t anything like wliat 1 thtnight 
I exjxcterl* Attendees were treated to a fascinating discussion 
o( bioUjgical ■sw'anir compuitT moik'ls - how to use ideas 
gained from t>bseiving ant colonies. ix*es, wasps, etc. to make 
new and efficient computer systems, ’rhe ideas were described 
a.s “simple rules’" and “boitom'tip modeling’'. They sound 
simple, but they work. When Southwest Airlines a|)f>lied ihese 
models to their air cargo transport, tliey improved their 
efficiency l)y 1^A\ and saved millions of dollars, by u.stng a 
“traveling sales anC ulgoriihni. 

After lunch, there was a presentation (ur an Open Source 
semantic search engine project, given by a speaker from 
NITLE (the National Institute for Technology and Lil)eral 
Education), llie presentation w'us made even more interesting 
because the initial set of data ttseil for the project w^as from 
Steven Johnson’s book EmergetiLe: The Cottnecled Lives of 


Vicki Brown has Ixen happily ff>llowing the latest emetging technokjgies smee the early I980’s. Snaie of tier favorites include Unix, Mac OS, PDAs, 
and the She can’t wail to see wliat emerges next year. 
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Multiple formats. Multiple platforms. 
Complex installers. 

Aladdin solves the compreswn and installation puzzle. 


Trying to figure out how to handle multiple 
compression formats and platforms? 

The Stufflt Engine solves the compression puzzle. 

Aladdin's Stufflt Engine SDK: 

>■ Adds value to your application by integrating powerful compression and encryiition. 

> Is the only tool that sui)poi‘ts the Stufflt file format. 

>■ Provides a single API that suppoiis over 20 compression and 

encoding fonnats conunon on Macintosh, Windows, and Unix. 

> Makes self-extracting archives for either Macintosh or Windows. 

>• Available for Macintosh, Windows, Linux, or Solaris. 

Stufflt Engine SDK' 

The power of Stufflt in your software. 


Licenses start as low 
us $99/year 

To learn morCt visit: 
www.sUjITUxoni/sdk/ 




Looking for the easiest and fastest 
way to huild an installer? 

Stujjllt InstallerMaker completes your puzzle. 


It’s not enough just to write solid code anymore. You still have to write an installer 

for your users. Stufflt InstallerMaker makes it simple and effective. 

> Stufflt InstallerMaker gives you all the tools you need to install, uninstall, 
resource-compress or update your software in one complete, 
easy-to-use package. 

>■ Add marketing muscle to your installers by customizing 
your electronic registration form to include surveys 
and special offers. 

> Make demoware in minutes. Create Macintosh 
OS X and Macintosh Classic compatible Installers 
with Stufflt InstallerMaker. 

Stufflt installerMaHer 

The complete installation solution!'' 


Prices stjji al $250 

To ieam more, visit 
www.stiiffit.com/ 
insUillernuiker/ 


rnXSystems 

www'.stuffit.coni 
(831) 761-6200 

© 2002 Aladdin Systems, 
kic Sluffll, Siuffil 
hsJollarMoksr, and SlufTfl 
Engine SDtC are frademarks 
ol Abddin S/s^tsms, ln<. Tha 
Aloddin Jog^o i& a regisfarad 
irackmark. All oihef pfoducti 
are trademarks or regislefod 
Iradernqrks of Hieir ra^spactive 
holder.*;. All Rights R-aservad. 














Ants, Brains, Cities, and Software. More swarms,,, 
apparenrly there are (no?) coincidences in the area of 
cmcrg i ng Lee h no I og ies ”. 

We then stopped by to chat with tlie folks at the Internet 
Archive Bookmobile, 'Ilie internet Archive is collaborating with 
numerous libraries to digitize as many texLs and fxjoks as 
possible, The Bookthobile is making "out of print” (and/or out 
of copyright) books available to people one book at a time froin 
the back of a vvell-ec|yipped minivan eontaining an HP 
duplexing color printer, a couple of laptops, a desktop l)inding 
machine, and a paper cutter. 

The Ikxjkmobile is a demo of a public domain application, 
It addres,ses the [)asic question; “Wliat gtx)d is the pul^Iic domain?” 
One thing the public domain excels at is cost reduction. Tlie folks 
in the bookmobile pa^jecl estimate that they enn print and bind a 
\x>ok for less tlian it costs a library to lend out and re-shclve that 
same book, (Of course^ this doesn't apply to Ixnaks currently 
under copyright, but it's an intereiitjng idea all the same!) 

Day Two 

The first keynote speaker of the second chy w^as Alan Kay, 
one of the invenkjr.s of SmallTalk, He gave a well-aiiended talk 
on User Literface iiistory, entitled Daddy, Are We Ihere Yet, 
complete with video clips. Many of the things we take for 
granted today were in rt^search lai>s 40 years ago... yet some of 
what was in those labs still hasn't imide its way into euirently 
available computing interfaces* 


Presto Vivace, Inc. 

Fast and Lively Public Relations 

Presto Vivace specializes in public relations 
for small technology companies. Our press 
contacts database is now available for 
companies to manage their own publicity. 

For only $99, you can use our professional 
database to place your press releases. 
Available in Apple Works format; e-mail 
marshaIl@prestovivace*biz for sample. 

4902 Powell Road, Fairfax^ VA 22032 
703/426-5876, fax 426-5892 

http://www.prestovivace.biz/ 


Tlie second keynote, Personal Interfaces, was presented by 
Kevin Lynch of Macromedia. 'Hie talk focused on whai 
M^icRimediii is doing to turn Fbsh (originally an animation engine) 
into a much more functional development system. Tile result will 
be the ability to create desktop Internet applications that will still 
work even after being disconnected from the Internet. 

The third keynote was an energetic and very interesting 
discussion of social staicture and social software, with the 
intriguing title, A Group Is Its Gum Wotst Enemy. This talk was 
presented hy Clay Shirky, Clay Ivds achieved a place on my 
.short list of "must hear” speakers - no matter what the topic, if 
he's speaking, attend the talk! 

Stxial software is software Lliat supports group interaction. 
Prior to tlie internet, the last invention that really affected the way 
people communicate with each other in groups was the table. 
Today we have forums, email, wikis, IRC, and more- all work la 
one extent or another, .supporting some form of social 
communication patterns. As Internet "grouping” lias liecome easier 
and more popular, we have passed the mid-.saile group.s sizes 
where fx^ople can easily have conversations and get tilings done. 

Using real-life examples, Clay showed how groups start 
out, grow, change and (sumelijnes) destroy themselves from 
within. Every grouf) eventually reaches a "constitutional crisis”. 
I low' the group handles (or misdiandles) that cTisis determines 
its siirvhval. Although our software is teclinical, groups are 
social; grtmp interactions (and problems that arise as die result 
oi those interactions) cannot he handled in a suictly technical 
manner, In group intemetions, .social and technical issues are 
inextricably interlw^ined. 

Day Three 

We missed the first keynote on the third day, but caught 
the second. Goodie, hinovcition, and the Web wa.s presented 
by Craig Silverstein, the first employee hired by Google's 
founders and now Google's Director of lechnology* The talk 
really impressed me. Google, Inc. combines careful hiring 
practices, a short but articulate mission statement, 
innovation, experimentation, focus on user experience, and 
a firm understanding of the need for process. Not only that, 
they liave been successful with this combination and believe 
they will continue to be successful. Here’s a company that 
actively pursues code reviews, .status updates, engineer 
testing, and product maintenance - and they admit it in front 
of an audience. 

Eric Drexlcr’s keynote provided a fascinating, animated 
discussion of the [>ast, present, and possible future.s of 
nanotechnology, entitled Nanotechnology: Bringing Digital 
Conirol to Mailer. He lx:gan with an intere,sting ejuestion: Wliai 
Ls tlie main digital storage system on die lajKop computer in 
from of you? The surprising answer: It's not the hard disk. It’s 
the DNA in the myriad baaeria that are contaminating the 
surface of the machine and iLs parts. 

Nanotechnology can harness and combine principles 
demonstrated by the bacteria; principles demonstrated in namre 
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by cheinical reactions, biologicaJ systems, and physics, as well 
as the principles of computer science. The suuting point in 
understanding what nanotechnology can bv Is to realize a 
fundamental principles If a given thing exists, things like tiiat 
other thing are pcissible. Nature shows us that molecular 
machine systems can exist: cheaply, cleanly, and working with 
molecular precision. 

If you are intere^sted in tile future of nanotechnology, take a 
look at the sites for the Center for Responsible Nanotechnology' 
as well as Dr. DrexleTs organization, die Foresight Institute. 

Mac os X Innovators Contfst 

The O’Reilly Mac OS X Innovators Contest debuted in 
March and received nearly KXJ entries for its first round of 
comperifion. Winners were announced on the second day of the 
conference, with a reception that evening. 

Second prize was awaaled to Rob Beale tor Spring, 
described as a "wildly innovative universal canvas”. First prize 
was awarded to Brent Simmons for HettJewsWire, considered 
“one of die most popular new ajips for Mac OS X”. 

ClCXSINC; rHOlJCiHTS 

This was easily one of die lx\sl ctinfcrences I have attended 
in some time No session that I attended was quite what 1 
dioughl 1 expected going in. Every session gave me something 
to think about and to discuss for days afterwards* No session 


was Ixiring or uninteresting, J diink this is the first conference I 
liave attended where 1 can tiiily make all of those claims. 

As the week ended, 1 was alrcxtdy wondering what 
technology will lie emerging next year. FU be at the 2004 
conference to learn more. You should be sure to attend, too. 

Rlillim-NCLS 

Session summaries and ibllow-iip coverage ol Ftech 2003: 

http://conferences,oreflly.com/etcon 

Information on past and iLiturc O'Reilly conlerences: 

http://conferences.oreillyxonn 

Swarm Inieliigence: An interview with Brie Bonabeau: 

http://www.openp2p.com/pub/ci/p2p/2003/02/21/bortabeau.html 
Hie National Institute for Technology and Liberal Education: 
http://nttle.org 

The Internet Arcliive Bookmen bile: http://archive.org 
Lessons from tlie Internet bookmobile: 

ht^://www.orGil[ynet.com/pub/a/network/2002/10/18/bookmobfle 

fjocial Software and the Politics of Groups: 

http://shifky.conn/wrilings/group^politics.html 
Hie Center for Responsible Nanotechnology: http://crnano.org 
The Foresight rnstitute: http://www.foresight.org/ 

Mac OS X Innovators Contest: 

http://wvwv.macdevcenterxom/pub/a/mac/developer/2003/04/24/innovator5.html 
Spring: http://www.usercreations.eom/sprmg/ 

NetNewsWire: http://ranchero,com/ 


ListSTAR® 

www.liststar.com 


The most flexible email processing system available. Easily create mailing lists or 
email-on-demand services. Use built in rules and/or AppleScript/AppleEvents to handle 
any email task, no matter how simple or complex. Demo available. 


MacRADIUS” 

www.macradius.com 


The easiest to use RADIUS server available. The groups feature allows you to make 
changes for a large number of users in one easy step. Enabling or disabling access for a 
user or a group of users is a one click operation, without having to stop the server. Support 
for AppleScript/AppleEvents makes it easy to control MacRADIUS. Demo available. 


SimpleText Filter 

Plug-in for EIMS* 
www.mcfsoftware.com/stf/ 


Easy to use header and content filtering. Scan incoming messages for sequences of text, 
digits, etc. Base64 messages are decoded so you can check for content despite attempts to 
hide the text. Demo available. 


Auto Reply 

Plug-in for EIMS* 
www.mcfsoftware,com/ar/ 


This plug-in allows you to easily set up auto-reply messages for 
users. Addresses that have been sent auto-repiy messages are 
tracked, preventing auto-reply message loops. Demo available. 


Address List powerful utillfy for sorting and cleaning email lists. Sort 

email address lists in alphabetical or domain order, remove 
Sorter duplicates and improperly formed addresses. Demo available. 

www.mcfsoftware.com/als/ 

*EIMS-Eudora Internet Mail Server (www.eudora.co.n 2 ) 



...simply 

dependably 

engineered 

www.mcfsoftware.com 
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Get more out of your Macintosh! 

DevDepot sells the tools, toys and technology to put more muscle into your Mac. Innovative 
upgrades, essential accessories, and cutting edge new products for those of you who just want more. 

Visit us at Apple's WWDC and Macworld New York! We're easy to find, the lorgest retail 
presence at WWDC and official store of Macworld. 

DevDepot has it ail! 





500 GB on your Desktop 

The Big Drive from LoCie, FireWire 800 
and all the capacity you can ask for. 



Put 80 GB in your PowerBook 

Why leave it behind? Keep all the data 
and applications youneed on your 
PowerBook or iBook. 



Add a SuperDrive 

An internal SuperDrive does it all - 
DVD“R/RW and CD^R/RW in one drive. 
iDVD compatible, 
easily to install. 


Bvttvrtvwmh 



Lucid FireWire Powered 
CD-R/DVD-R 

Lucid CD-R/RW and DVD-R/RW 
drives are iTunes compatible and t 
powered. Portable and Powerful!! 





Haritian Kordin USB 
Speakers 

No audio out, no problem! The 
best looking, great sounding 
speakers for USB Mocs. 


JBL Invader Speakers 

Dolby 4.1 speakers and amp for 
your Mac or iPod! 





PowerWave USB Amp 

Audio interface and amplifier 
for your Mac or PC, connect 
your home speakers or sound 
system to your USB Mac. 


Noise Reduction 
Headphones 

With airline adapter, the perfect 
companion for iPod and 
traveling with your PowerBook. 























HARMONi for iMac 

Pump your original iMac to 600 
MHz G4 and add FireWire! 



Macintosh RAM 

RAM upgrades af great prices, designed and 
built for best performance and 100% 
compatibility with your Macintosh, 



G4 Upgrades 

Put up to a 1.2 GHz G4 in your 
box. Upgrades for your G4 Tower, 
your iMac, Blue & White, Beige G3, 
8500 and before! 


Wallstreet G4 

Your Wallstreet G3 PowerBook can 
have a 500 MHz G4 Processor! 


PowerMate Analog Control 



rnntrol iTunes or DVD Player, edit 
home movies or just use it next 
to your mouse as the ^ultimate' 
scroll wheel! 



Airport USB Adapter 

Add Airport connectivity to your iMac, 
PowerMac or any USB Macintosh! 


Wireless Mice 

Finally a wireless mouse for Mac, 
done fightl Portable version for 
PowerBook users or desktop version! 


keCAD 

Ideal tool for Apple InkWell for 
handwriting recognition, freehand 
sketches, or use with graphic 
applications. 








iTiip 

The ultimate iPod accessory, plugs into your 
iPods FireWire and Audio ports, FM 
broadcaster, powered ond controled throug' 
your iPod* 


Better AC Adopters 

The smallest, most compact AC adopter 
for PowerBooks and iBooks. One adapter 
for home, one for the office! 


Replacement Batteries 

Long flight or multiple meetings, do you 
need more juice? Batteries for G3 (Pismo, 
Lombard, VVallstreet) and G4 PowerBooks! 


The PowerBook Handle 

A must have for G4 PowerBook users, put a handle 
on your PowerBook and great to prop up your 
PowerBook for a comfortable tilt. 


j 





Outside US/Canado: 805-494-9797 • Fax: 805-494-9798 • orders@devdepot.com • PO Box 5200 • Westlake Village, CA 91359-5200 


































By John A. Vink 


Puzzle 1: Send it by RegEx 


Try to .solve tliis programming puzzle before the score drops 
TO zero, nie puzzle is presented as a discussion among 
engineers in a chat room. As tlie engineeni gatlier infomiaLion 
and make suggestions^ see if you can find the solution. If you 
solve the prc^blem before you get to the end of die puzzle^ you 
get the score in the left hand column. 

We Stan off our initial monthly puzzle with something simple. 

ChrisE: OK, serious cjLtestion. 

100 ChrisE: find . -regex ’'.VVersions/lABCDEFOl/lA/]*" finds 
me all the dylibs in /Sysiem/IJhrary/Fnimeworks 

ChrisE: But it also finds the _debug and _profile versions. What 
do I do lo I he regex to exclude files drat have a _ in them? 

95 JAV: Is a pipe to giep -v out of the question? 

ChrisE: Yes 'cuz it’s the -regex arg Lo find and 1 want to do a -exec\ 

90 Hie R, Square: You want l^J in there .somewhere. 

ChrisE: tried [Aj* 

85 BMA: Ide* the prolilem is llial regular expression matches 
any .sul^jsiring of tlie path. 

BMA: ChrisR, I believe you w^ani -prune. 

80 Pie R. Square: Does rliis give you want you want: find . - 
regex ".*/Versions/IABCDHPGl/I^/J*" 

ClirisE: Yes, it does, Tlix, 

75 BMA: No, Pie, because [a/J* matches the empty suing. 


Keith: Wouldn't you want IaJ+, since you always want at least 
1 t'haracter in the filename? 

TO ChrisE: Luckily I'm not passing it any empty strings. 

BMA: 1 believe you need to put the regular expression between 
^ and $ in addition. 

65 BMA: Ah, i see, -regex in find is implicidy A$, 

BMA: No, Pie, con,sider this: 

60 BMA: "foojiar" 

BMA: matches "foofAj*” 

BMA: because there i.s nothing saying "niatcii the entire string". 

55 BMA: OK, then what Pie said wall work, CiirisE. But in 
general, you can't assume that. 

ChrisiE: Well, the problem is to find all dylibs in 
ASystem/Library/Framewcjrks and exclude _debug and _profile 
libs, and it work.s for this one case, .so Tm there. 

ChrisE: Tills is just adhoccry, not production. 

Pie R. Square: How could it not he? 

50 BMA: Pie, regular expression "a" is matched by string "hab^ 

BMA: likewise regular expre.\sion "a*” is matched by string "bcb”. 

PieH, Square: 1 just meant, i wuukin'l expect find to work that way, 

45 BMA: It is the only tool tlial i have ever seen that takes a 
regexp and implicitly puts it inside A$ 


John A* Vink (aka "jAV") is a software engineer ftir Aj^ple Coiupiiter, Inc. Be takes a break in the suninier to fallow fNXS on lour. His pals are a 
hunch of smart friends .scattered ihroughtrui the Mac programming landscape. You can coniacL him at vink@apple.com, (Ihe pals reference makes 
sense wiiii the "John And Pals' Puzzle Page" title) 
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40 Keith; Gin you pass two -regex argiirnenLs to find, and 
have the ,sea>nd tine Jk' fA(_dehug) | Gprofile)]. I can't tell from 
the manfiagc vvIicUict that wt>uld work or not, 

55 R- Square: it didn't produee any output. 

50 OMA; A doesn't work tliat way^ Keith. 

ChrisE: ft worked. Give it u[), Tve done what I need to do and 
have niovtxl on. 

Pie R. Square: ChrisB, you don't know us very well, do you? 

25 BMA: Alst), 1 tb want to consider the more geoenal pn>hlem, 

BMA: It luras tint dial you could match your exarl set with a 
regular expression in this case. 

BMA: But what if ihe include and exclude sets need a regitlar 
expression? 

20 BMA: laK)ks like find regex HEl -and \! -regex RE2 works. 

15 Keith: fry adding a \f -name "^'^_def>iig'" \! -name 

^”'_profille"' to the find, ChnsE. 

ClirisE: No, It worked, I'm done. You try it. 

Keith: ] did. It seemed to work lor me. 

ChrisE: Lucky you. 


10 JAV: ReineinlxT Kon ik Bal’s Puzzle Page? Lots of 
conversations here sound like that. 

BMA: I f(KXKKKKXKHKHKK>ove Kon and Ball 

5 BMA: I am so sad there is nothing like that now. 

JAV: Well, we can extract the chats from here and make one. 

Pie U. Square: How' about iliLs cfiaL^ 

Btibba: You should play poker with Kon. 

Bubha; Hey, we could get a column in that prognimmers 
magazine! 

JAV: MacTech? 

ChrisE: Gotta go, see y'aJI later. 'Ihunksf 


Score: 

85-100 Gin 1 borrow your regular expres,sums liandlxKik? 
65-80 Don't go away, mayte you can help me with this 
other problem.,, 

45-60 Yeah, 1 remenilier using Unix in college uxi. 

25-40 If you can! find it, the Tennina! application is in 
/Applications/Utilities 

Still using Mac OS 9? Time to upgrade to that new OS. 


REALbasic 
AppteSeripL 


Direelor 


Java 


C-H- 


XCMD 



SuperCard 


Valentina 

Object-Relational SQL, Database 

The fastest database engine 
for MacOSAVindows 


MetaCard 



s 

WebSiphon 


futureBASIC VisuatBasic 


It Operates lOO's and sometimes 
a 1000 times faster than other systems 

www.paradigmasoft.com 

Hasted by maeservemet 
Download full featured evaluation version 
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MAC OS X 

PROGRAMMING 

SECRETS 


By Scott Knaster 


Mac OS X: Wading In Deeper 


This month we'll continue our peeking and poking around 
tlic edges of Mac OS X as we prepare for deeper voyages into 
OS X pnjgramming. In our last Uirilling installincnl, we weix.^ 
mes^sing around with 'lerminal and finding out about how it 
could enhance and enrich the lives of even those who spend 
most of their time above the Gill line. After cranking up 
lerminal, we discussed a few shell commands and introduced 
some useful tips for being more produciive. We'll continue along 
those lines this time, exploring some more features of Terminal 
and its shell windows, then kwking at a ctjyple of lesser-known 
but usefii! shell commands. 

Terminal Condition 

Apple has done a good job of hiding most of the scars 
where Mac OS and Unix have been Frankensteined together, 
but there are still some design choices In wliicfi, sliall we say, 
Mac user interface standards have not yet won the day. As y<^u 
use Terminal, you probably noticed that things are just a little 
wacky here and there - Terminal liasn'i £[uiLe completed the 
transition to liecoming a full Mac ap]'>lication. For exiimj>le, 
take a look in the Edit menu: there's no Undo command What 
a giveaway! Let's lake a k>ok at some of the other C£)ol tric ks 
and odd quirks of l*erminal. 

Every shell wirnlnw in Terminal i ml tides a little picture nf a 
torn square just above tlie .scroll bar. See it? Hey, that's right 
where the S]:>lit winckw control is many Mac ap]>s. Could it lx.* 
llie same here? Yes, and no. It's a son of mutant splitter. If you 
click on it, your window will indeed split into two panes (see 
Figure I). However, only the top pane gets a .sctoH bar. The idea 
is that the IxvUom pane always shows the latest inteiuction 
ix^tween you and the .shell, while you can .scroll back in the top 
pane to any pan of the shell ses-sion. Ytxi can even select text in 
the lop pane, then drag and drt)p it into the bottom, wheie it 
.shows Lij) at the insertion point. To put the window back 
together in one piece, click the now-whole scfuare that appears 
ai the top of the kiwer pane. 




Terminal icsh -- itiK — 13) — j* 1 
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Lnnli;*/r(w.pa^nl*J | 


Fl^^ure /. Spin Ttmniiuif window niib one scroll bar 
and nnsplit command. 


Although window splitting is not done in tlie familiar Mac 
w^ay in Terminal, there is a standard technique for fooling with 
colors. List month, you iiiiglu recall iluii we discus.sed dianging 
the colors for the text and background in your siiell windows by 
using the Color window, There are a couple of additional 
features w'orih mentioning for changing colors in shell windows. 
Take a kx>k at the Color window in I-igtire 2. The Color window' 
is a .standard OS X component that you see in lots of apps, and 
you can even use h in your own creations, so everything we 
discuss here is also tlemocratically available to you. Take a look 
at the tiny magnifying gla.ss at tlie leh side, near the top. Yon 
might not guess it, bui ifiat's a button. You ran use it to pick a 
color you like from anywhere on the screen and use it in your 
shell wandriws. 


Scott Knaster lias l>een WTiting afxmt Macs tbr as long as theie have lieen Mars, Scott'.s lioijks Hou> To Write Madntosb So/ttmre and MadrUosb 
l^gmmming Secret: were lequiied reading for Mac [irograniiiiers for mure than a decade. Scott wreXe devdoper books for General Magic and worked on 
Mac software for Mkrosoti. Scon's lxx>ks liavc been tmn.slatcd into Japanese and Pascal, tkott has every issue of Mad magazine, whitrh explains a lot. 
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What does software protection 
have to do with money? 



11 billion US$ lost worldwide 
through software piracy! 


WIBU-KEY Software Protection 



■ Software goes online 

Electronic Software Distribution 
safely protected by WIBU-KEY. 

■ Pay-Per-Use 

Usage dependent accounting of 
your software. 


■ License Management 

You can easily and flexibly create and 
manage network licenses. 

■ MacOS9&X 

WIBU-KEY supports Mac 05, Windows 
and heterogeneous networks. 


I fiuf. i:fi (i V\f\ R (J-ffRY P ro i o n fl 
free arid clrtdda for yer/rteffl 






rfij ei;(^(3 rrfteeh vee m 



The Key is in Your Hands! 


UIBU 

SYSTEMS 


WIBU-SYSTEMS USA, Inc. 
Seattle, WA S810t 
email: info@wibu.comi 


WV\IVM\: li'teeh ..co lyi 

WW\f\kW 


Test Kits also available at: 

Srrgium wHsuttimpaittJie, OBnmftrfc leanOOanOitdk. Hnfai>d flrtetayt*<Hinwfayt<3.c€m. FranccH info^neol fr, tiungary intoemmfthUr iapan lnf^jJUfirifl#.co,rp. 
Jonfjtn, l#b4noni «t*i«oritfcybarrl 4 -)iM.lb. KarAp dhicifnrfiaiwilMi.co.kf, Luxembourg i^ibueimg«kt be. Netherldind^ wibti<Oltfiipakt.t»e, 

Ponugal diibitedubitpt, Thailand pnwrhniidpil-th.com. United KJr»gdom in^ffOcodAwOrk tOm, USA laiesOgriftecb rcim 



















Long Distance 






Straight 6 setond bilfing ihWeinenfs 

Excellent rotes on intrastate, introlato/toll calls 
and international calling with no term contract. 


Toll Free (800/888/877/866) service, 
same low per minute rate for incoming calls. 


10 cents per minute calling card. 

Detailed billing directly from Capsule Communications, a Covista Company. 

Quality electronic and telephone customr support. 
No monthly billing fee if you sign up for AUTOPAY billing 
option or if your bill is over $20.00 each month. 
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Figure 2. Color uimhwfrofn lerminai 

When you dick \Uc jn[ignifyin>» rhe cursor changes 
to a bigger magnifter, and wlien you click elsewhere, the 
color under the magnifier's crosshair is sucked into the 
horizontal box next lo the magnifier control in the Color 
window. Once the color is in that box, you can drag our of 
the l>ux and drop the color into your slid I windows Lo 
change the appearance of various things, depending on 
where you drop \L You can set the color of text, the 
background, bold text, or even the cursor rectangle. Try to 
be careful not lo set the test and background to the same 
colon green on green (for ex:nnf)le) lext is hard to read. If 
that happens to you, just get another color into the box and 
drag ii into the window. Either the text or the background 
will change color, and your lexi will be happily visible again. 

Take a look at the bottom of die color window. You1l 
see a row of small white boxes. ^I'hese boxes arc sort of a 
scratch palette ftjr your favorite colors. Each box can hold 
one color. To try it out, drag out of the long color !x>x at the 
lop of the w'indow, and drop into a little square at the 
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bottom. The color you dragged fills up the palette square you 
chose. You can repeat this for the other squares m the 
palette, pulling other colors in the ct>lor box at the top and 
then storing them in the palette for safekeeping. And, the 
palette has a secret; it's actually much bigger than what you 
see in the color window. If you stretch the window to its 
maximum size, then drag the grabber ai the boUt^m-cenier iif 
the window down, you'll see that the palette can 
accommodate up to 300 colors. That .should be enough for 
coloring sliell windows, or even redecorating your house. 

The last Color window feature we'll point out is the i)ar 
at the top that lets you select different methods of chfKJsing 
your cc^lors, inti tiding a color wheel, sliders that let you 
specify colors as RGB or other values, a set of palettes such 
as web safe colors, an image that contains colors you want 
to copy, or even a set of crayons. Figure 3 has a picture of 
the crayon pickcT, with some colors dropped into the palette 
at the Ixittom, 




Unon 



Figure You can pick colors using crayons, and }X)u can save 
yourfavoriies in the/kilette at the iTtUiom. 
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The newest addition 
to every SREfST 
developer’s diet. 



Easy to learn and use 
Complete more testing faster 
Test any application on any system 
Ailows testing of remote systems 
Captures test resuits visuaily 


S Jesf 8(y appScation on any system. 


www.niacegg.com Redstone 































Ejn'iitlemen r Issues 

Winchw lillc f>ars in Teniiinal are another departure from 
standard Mac behavior. While most apps have already riecided 
what they want to put in the title bar (usually the name of the 
document you’re kx>kin|' at), Tenninal goes to great geeky 
lengths to let you cystomi7.e the text in title bars. Using the File 
--> Show Info menu item to display the Terminal Inspector 
window (see Figure 4), you ean chcxise from several options for 
your shell window titles, including these: 


Q Terminal Inspector 

4 -- 

Window 


Dimensions: 

98 Columns 


34 Rows 

Title; 


sec shell 

2? Active Process N'ame 
2! Shell Command Name 
2! TTY Name 
2 Dimensions 
d' -term filename 
2 Command Key 


( Use Settings as Defaults 


figure 4. Terminal Inspector umdow let& you decide what goes 
in each shell window^s tale ime which Lk an mmimme 
res}X}nsibiliiy ytm should not take lightly. 

"Active Process Name" puts the name of the cotnmand 
being executed into the litle bar So^ for example, if run an 
editor like vi in a window, Terminal will put vi into the 
window title. 


"SheU Command Name'' displays the name of the shell, such 
as bash or tesh, thar^s running in the window. 

''Dimensions" tells the number of cliaracter rcjws and 
columns displayed by the window, which lets you continue the 
fantasy that you’re computing in 1972. 

When you have multiple Terminal windows open, you can 
.seleti each one witli a command key shortcut: command-1, 
commajid-2, and so on. Checking ’'Command key" shows the 
window's shortcut in its title bar. 

Changing any of these settings affects the frontmost 
Tenninal window immediately. In fact, if you resize the 
window and you have the dimensions displayed, yoiill see the 
number c:hange live as you drag. Pretty slick for some old 
terminal program. 

If you decide you like the settings so much thai you want 
all Terminal windows to appear that way, click the "Use Settings 
as DefaulLs" Ixition at the bottom of the window. 

At Your Comm4ND 

Now that wc know liow to customize our Terminal 
w'indows to a fine degree, lefs take a look at a couple of shell 
commands and other tools that are useful bo\h for using and 
programming with OS X. Well start with a command that helps 
you learn more about what's going on in the vast active culture 
inside your Mac. Ihe top command examines all the things 
running on your OS X Mac and [movkies infomialion about 
them. To try it out, go to a Terminal window and type top and 
return. Here's wliat happened when I did it: 
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Gosh, that's a lot o\ srut’f, I sure hope there's nothing 
embarrassing in there. 

top gives you an cvcr-updaling list of all the processes 
rurmiiig in your Mac, with lots of juicy information about 
each of them. If you keep an eye on the top display, you'll 
notice that it keeps changing, producing new numbers every 
second. If you launch any other apps, or even if you open a 
new shell window or do anything else that starts a process, 
you'll see a new eniry in the list. Similarly, processes drop off 
the list when they're stopped, as when you quit an 
application or close a 'terminal window. 

Processes are listed in rever.se of their launch order, 
newest first. The numbers in the first column are the process 
IDs, followed by the name of the process or application. 
Obviously, there's an enormous amount of information here. 
We'll go over .some of tlie most interesting items here, and 
refer you to the man entry for full details. 

If you're playing along at home, and your don't seem to 
have as many processes U.sied on your computer, you might 
not be getting the full picture. To make sure you see as much 
of the top display as possible, stretch your Terminal window 
OUT to its maximum size, and then use the Font menu to 
make the window's font small enougli that you see all the 
processes. You know you're .seeing it all if you can see 
process 0, idle_thread, listed at I he bottom. 

Coming Out On Top 

Now let's make some sense of this display, starting with 
the [leader that appears before Lite list of processes. The first 
line of output teils you the number of processes and threads, 
while the value at the end of the line is simply the time of 
day, so you can ii.se top a.s a super-complicated clock if you 
like. Another interesting value in the header is the CPU usage 
in the second line. In this example, the CPU is 20.7% idle, 
which is aciiially cjuite busy - usually, ytru'll find the idle 
value much liigher than that. For fun, you can quickly whip 
the mou.se pointer around the screen, and you'll see the idle 
value go down as the CPU sweats to keep track of it. 

Tile meaty part of the top display is the big list of 
processes. As we mentioned earlier, the first two columns are 
the process ID and the "command" name, which usually 
includes an entry for every running application. We can also 
see that several shell commands have their own listings, even 
lliough they aren't applications. These inckide several tesh 
shells and top itself. The first value after the command name 
is the percentage of CPU time being hogged by that process. 
For example, you can see that Terminal wa.s grabbing a 
whopping 53.2% of the CPU's time when this list was printed. 
Even for the active application, that's quite a large fraction. 
You can use top to help determine if any particular app, 
including one you're programming, is taking up more than its 
share of CPU time. 
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Whai else is iniere^iirig in this Ibt? Note that the next item 
under Terminal is using 9.9% of the CPU lime. The name of that 
process is...Microsoft? Micrrxwft what^ Word, Excel, MSN? 
Unfortunately, there is no way to tell. A regretuible artifact of 
Mac OS X's Urdxness is that there isn't enough room for ptfxess 
names that are as long as some Mac application names. One way 
to Figure out which Microsoft application is which is to bring one 
lo the front, tlien start typing. One of the apps will suddenly start 
taking a lot more CPU time: that's the active one. On the other 
hand, if you see any applicaiion that Lake,s a lot of CPU time 
even when ills not frontmast, you might be able to improve your 
Mac's performance by replacing that app. 

top includes a couple of command line options that you might 
find useful. The -u <jpik>n keeps tlie list of processes constantly 
sorted according to usage, rather dian launch order 'lliis makes 
you a little crazy hut is kintl of hin to watch and ensures you know' 
which tasks an: tLsing the most CPU lime. You might also like to 
try Uk: -s t)j)iion* which takes a value after the s to indicate how 
many seconds should pass before updating the display. 

Tiur's A Man, Baby 

To i>ecome more adept at Unix commands, 111 repeat ihai 
you should make fre{|uent use (>f die man comiiumd. This 
command gives you pages from the Unix online "manuaP, 
which was a really clever idea hack In 1906 when Unix was 
invented and is now scimetirnes barely adec|uale to help you 
figure tint what's going on. The man dcxuineotation wasn't 
written by the literate folks at Apple, but you'll need it 
sometimes to gel you through the night. 

Wllcome To The Machine 
We'll finish by talking alxiut one more little shell cf)mmand 
of interest: machine. This command works under Mac OS X to 
tell you w'liich CPU your computer is using: if the Mac has a G3, 
you get ppc750, and a G4 reairns ppc7450. These are Motorola's 
part numbers for the chips, useful if you ever find yourself 
wanting to order CPU manuals from Motorola. 

Finally, be sure you check this command's man page. If 
you do, you'll Find the less-lhan-cniiglitcning guidance that 
The machine command is currently under development." 
But the real fun is that you get to type man machine. 
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REVIEW 


By Michael R. Han>ey, Remews Columnist 

PowerKey Pro 650 


Surge protection taken further 


Sut^c protection is a normal 2 ind necessary pan of any 
computer system. From the basic bar you can get from the 
a)rner store, to the big power conditioning systems for data 
centers, it all comes down to one tiling, pit>teaing the expensive 
parts from electrical damage. In other words, defying the old 
saying, and not letting the $10,(,)00 equipment blow to protect 
the tea cent fuse. 

'I’he folks at Sophisticated Circuits have come up with a 
protector that, while not a battery backup (although it can lie 
plugged it into an iminterniptible t^wer supply), is far more 
than just a plug bar The PowerKey Prti 650 is a surge prolecttir 
that comes with a few tmly spectacular extras. 

Thf harowarf. 

To start with, it is tlesigned to handle six large power 
adapter plugs, a nice bonus when trying to get everytliing to fit. 
It is rectangular in shape, with three side by side power outlets 
running down each side. Fach scx:kei lias a slide [hat ctivers the 
outlet when not is use, and provides a snug hold when a plug 
is insc^rted, so no loose plugs falling our at a critic';]I moment. 
Each outlet is individually controlled. You can turn ent‘h on or 
off from a button on the device, or from software. It also has a 
USB ctinnecior in tirder lo hook up to your computer for that 
control software to work. The cord is somewhat longer than 
your typical powt?r i>ar, a nice detail that lets you reach the wall 
outlet iliai is always “that mut'h’* too far away. Last, pass through 
phone jacks are part of the device for dial-in coniroh 

The PowfrKfy softoare 

The control software is what really sets the PowerKey 
Pro 610 apart. There are several comjionents. The first, and 
most important, is PowerKey, the main control software. This 
is where the PowerKey really sets it.self apart. In order for the 
magic to work, though, the USB connector must lie liooked 
into the controlling compiiter directly. It won't work tliroiigii 
a hub. A calile is provided a.5 the connector on the PowerKey 
hardware is proprietary. This dtjcsn'l seem like a very good 
idea because if anything happens to the custom cable, youVe 
stuck. A standard port on the device would have been a 
better idea. 


@a Reboundl 



' System Crashes | Application Crashes | Other ] 


Create a I 09 entry when: 

?! the system crashes 

i?* application crashes/timed restarts 

Q the Reboundf Extension opens or quits 

( ViewLog.„ ; 


?! Start up 10 seconds after a power failure 


?! Periodicaliy restart the system:_ 

s M T V T F s 
Every i i ^ ^ i 

At '~S;1S PM : 


Figure /. PotiwKty upplicathnt Ffmvr SamT 

It is fitjm within Oie PowerKey appliraiion tliai you set mast of 
the pammeters for rlie surge proietion You am set wliich outlet 
switches on tlie others, set ones thai .stay on, as well as name tlie 
outlets to make identirK''alion easier. You am likewise give die device 
a unique name to make identilying multij^le attached PowerKeys 
cusicT. Fn>m die other tabs, you can .set scliedules for turning outlets 
on and off, or set hotkeys for the .sajne. You can even cstablLsh tone 
secjiienc'es rliat the .software will respond to fitmi a phone ft>r 
conlrofltng the outlets when ailling in to the FfiwerKey (if youVe 
plugged a phone line in, <if course). Tlie tab in Figure 1 shows the 
Power Saver settings. From here, you can tel! die PowerKey Pto what 
lo turn on and off in relation to wfait the Mac does. Ihe controlling 
computer system is identified by tlie happy Mac symbol. The lock 
symbol identifies an outlet you liave set to lx: always on, and no; 
affecteti by the controlling computer jx)wer oudet. On and off at 
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bug reports and change requests, define 
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Fast and secure remote access to your source 
files and defects — work from anywhere 

Advanced branching simplifies managing 
multiple versions of your products 


Link code changes with defects and change 
requests — know who changed what, when, 
and why 

Sea lable a nd reliable cross-platform, 
client/server solutions support Mac OS X, 
Windows, Linux, and Solaris 

Exchange data using XML and ODBC, extend 
and automate with SOAP support 

Licenses priced to fit your budget 


Seapine Software Product Lifecycle Management 
Award winning, easy-to-use software development tools 


Surround SCM 
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or call 1-888-683-6456 
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startup worked just fine on our teii sysiem. However, trying to turn 
the outlets off when tjur test system went to sleep never worked 
righL Tljc computer would try to go to sleep, but immediately wake 
up again* The PowerKey Pro would detect this and tasianily kick the 
turned off outlets bat^c on. Wc could n(A detcmiine exactly what the 
problem was, altliougli the system would go to sleep nonrailly when 
the PowerKey was not iastalled. 

Rebound! 

Tlie PowerKey application is not a!! there is for softwaK* 
control, however. The Admin Version of the PowerKey Pro has 
an additional application, named Eebound!. With Rebound!, you 
can monitor and recover from system and applitution crashes. 


ee Rebound! 



I System Crashes ( Application Crashes | Other 


Monitor system for crashes 
Restart if system doesnH respond for 
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Injure 2: Reb(mnd! Systems Ctwibes tub. 

As with the PowerKey application, the surge protector mii.st 
l>e plugged into one of the USB ports on the computer for this 
to work* Ihrough the cxjnneciion, the PowerKey will monitor 
your system, and rebcxit it if necessaiy, Either liecause of a 
cnish, or a power failure. In the System Crashes tab of RelK)und! 
(figure 2), you ran set various conditioas for Refxjued! to watch 
for to trigger a re,start* In our tests it worked perfectly. Rebound! 
deteaed an induced crash, and restarted the system, Wltile 
preparing to simulate a power failure, we had a mal one occur. 
The PowerKc^y brought the computer back up with no problems. 

Relx>und! likewise lets you recover from applic'atiiin 
crashes. In order for Rebound! to be able u> nuMiior an 


application, support must already be l)uill in to the program. A 
li.st of programs that liave this capabiliry can lx* found on 
Sophisticated Circuits web site* 

#ee Pow«rlC«v 


4 

Figure Rebound.^ Other tab. 

'the third tab in Rebound! lets you set what events it will 
re<x)rd tt> the system log, how long after a power failure to 
relx)ot, and schedule recurring computer restarts (figure 3). 

Exihas 

You are not, however, rest fitted to using these supplied 
a[>plications in order to control ihe PowerKey Pro, Included on 
the Cl) are extras lo help you inctjqxmue PowerKey control in 
to your applicatioas, and servers. There are plug-ins that supptxl 
PowerKey Pro in 4^*^ Dimension, the daialiase development 
system, and applications that supfx>rt ihe Wel>8tar API plug-in 
arthitecture. There b infomiation on supporting Rebound! 
tcclinolog)' with AppleScript. 1hey also include a 30 day, fully 
functioning demo of iDo Script SchedukT, a program for 
triggering AppleScripts on a set schedule, Last, an SDK is 
included to help you incorporate Rebountl! supptm directly into 
your appliaitions. li includes sample code, a CtxJeWarrior 
project dtx:umenl, and various stmrce files for adding Rebound! 
functionality to your application, 

CONC:Ll)Slt)N 

The PowerKey Pro 6S0 Is available in a SOHO crinfigiiration 
and an Admin version, lioih come with llie hardware, and the 
PowerKey control software. The Admin version additionally has 
ihe Rebound! program, iDo Script Scheduler, and the added files 
for controlling Relxjund! From servers, AppleScript, and witJitn 
your own programs. The SOHO PowcrKc 7 Pro 650 is S199, 
while the Admin ukkIcI is $299, direct from Sophisticated 
Circuits* It may seem a bit pricey, but thi.s tlevice tkxs nearly 
everything it is designed to do, and d(x*s il very well. Ten cent 
fuses beware. 

www*sophistkated.com 
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CodeTEST® software analysis tools — designed to guarantee your app is 
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USER INTERFACE 
DESIGN 


By Ed VanVliet; Director Of Application Demlopmenl; VVl 

Designing Interface Builder Palettes 


Simple To Advanced Palette Design 


Introduction 

Anytime you linve u. reusable user interface component you 
shoultl consider iniegraLing it into Interface Builder as a palette 
so it is readily accessible, lliis article describes how to make a 
simple Interface Builder palette and aisc) explains some design 
issues encouniered for more advanced palettes via the gra]>h 
palette dial was implemented at WI®. By way of introcliiction, 
Figure 1 shows the graph palette being used in an example 
appltcafion project. 

Main WtndcMM 01 Application 



I I EX„Gonlroiter Instance | 

I Ob^cl$ In j^inMenu nJb Graph View tnspector 

Application Menu 


figure 1 : 7 he Cmph Interface Builder FaleUe hi Use 


To make such an application, launch Project Builder and 
make a new Application-based project. Thai project includes the 
Interface Builder nib file called MainMenu.nib. Double click that 
nib file from widiin Project Builder to open it, lliat nib file 
contains an Application Menu and Main Window by default as 
shown in Figure 1. Dmg a new Pie Chart frotn die Gmph Palette 
to the Main Window of die project, resized it accordingly and 
finally use die Graph View Inspector to change the pie chart to 
3 line graph represenuition, as shown on the Main Window in 
Figure 1. Then .save the project to the disk. That is all that is 
needed to add a basic graph to an application. 

Hie aim of this article is to de.scribe how easy it is to make 
a palette similar to that used aUwe, to trim off a few rough edges 
liiat you will encounter when you make your own Interface 
Builder palette and then to describe an advanced palette design. 
But, before going into rhtise detaiLs lets first complete the 
example afiplication just described by adding data to it. 

Completing The Graph Project 
llie only thing left to do in the application described above 
is lo add your own dam to tile gjapll while tlie application runs. 
To do that, add a new controller class, called EX_ControIler, to the 
projen using File > New File > Objective-C class. Hien add the 
ivar EX_test_view to iis interface in the fife EX_Controller,h and 
add the following ctxle section to its implemeniaiion in the file 
EX_Contfoller.m: 

- {void)awakeFromNib 

I 

NSStcing ‘inputstring. •atringFormat: 

KSString *niainTitle, 'xTitleH •yTitlei 
unsigned f^hartType: 

double vat uni, value?., valued, value4: 

r JiK- follciwing Uifinc tin: attributoi i>f I he column clurn, 7 

chartType = VP^COLUMN^OUTPUT^TYPE: 

mniuTitle - e^This Is Hy Main Title": 
xTltlo = X’Axis**: 
yTitle - g-My Y Datal'j 

/• 'ttic foMowing data is hardcixlcd. but could have cojnc ffom any source, such as a 
daiabaMT Mrrvcr. 7 


Ed VanVliet is Dircaor Of Application Developmeni at WI wliere he help.s tlesign and cxiastrud hu.siness and engineering data systems. He designed 
the Peer Visual Server as well as interfaces to database systems, instrumentation and real-iinie data feats anti is trurrenily working on a variety of 
sy.stems and convetsion.s l)etween Wintlow.s and Mac OS X for husiness and engineering companies. You can contact him ai ed@wi,mm. 
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value1 « 100,0; 
valued " 50,0; 
value3 = 77*0: 
valued 22*0: 

/•Thf auiibwio and UaUi alJcnT arc tni« a string according to the 

s|)cciricaLioas In die documentation. V 

ntringFormat - *%f .%f *1ti" ; 

InputSiring ^ [NSString stringWithForniattstrlngFormat 
, mainlitle. xTitle. yTltle 
. valuel, value2* valued, valued]: 

rihc Ibllowing updates the view with tlte input string and type iiilunuaUt;n* wjileh 
will cnuhle the graph view to update to the new graph when needed. 7 

[ F*X_ t G s t_v lew V F N_up d a t e_u s ing^input _s t r In g; 1 tip ii t St r 1 n g 
output_type:chartTy'pel: 


The ^?ra|>h view ckfiniilons are maintained in ilie 
Vvidget_VP framework, so iinjion itiat framework at (he top of 
EX_Controllerm using this code: 

jjfimport <Vvidget_VP/Vvldget VP>; 

Finally, include that VvidgeLVP framework as a framework to 
link against in ihe application project. 

Then double dick MainMenu.nib to launch Interface 
Builder read in the BX^Conlroller dass definition (Using Class 
> Read Files **.) , instantiate it and connect the EX_lesLview 
outlet of that instantiaLion lo the graph view. 'I'hen rebuild the 
project, launch the resulting application and .see the data on 
the graph. Notice that a pie chart was dragged from the 
palette, it was changed to a line graph using the Graph View 
Inspector in Interface Builder and the example application 
changed that to B column chan when it executed. This 
example project and ihe graph palette may be downloaded at 
http://vmw*vvi.com/dovvnload/vvidgetuser. 

Notice litrw easy it w'as to make the graph and how 
virtually no description of programming or underlying 
implementation was needed. The next sections correct thLs 
situation by first explaining how' to make your own palette and 
then giving a liighdevel overview of the graph palette design 
in order to show how a large project may be handled in 
Interface Builder. 


Making A Simpip. Palette 

Use Project Builder to make a palette from scratch. 
Launch Projec t Builder, choose File > New Project and select 
Standard Apple Plug-ins > IBPalette. ’fhen name it and save 
it. I saved it as the name MylBView, so the result is a project 
wiifi that name, tn that project are a few premadc class files 
and nib files as .shown in Figure 2. The objective of a palette 
is to quickly set states of a controlled object, *so rhe next step 
is to add some state information to the object contn>lled by 
the palette. 
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A list of all the files in the project MylBView.pbproj 
Gocoa-Cofitainers palette 


Custom View Class Inspector 
Interface Builder hAylBViewPalette.nib Window 


MylBView.in source code 


Hf^ure 2: MylBVww PropU BuHdei* and the MylBVwwPaieile 
Interface Builder file^ 


Tlicre are tliree types of objects (Cl:isst^s) in ttie paleile, 
MylBVIew, MylBViewPaletl 0 anti MylBViewInspector. MylBView Ls a 
view class and the paleUe is res|Hinstble ftir defining tliat class 
and making and nitxJifying views (instances) f>f that class. A 
view is a rectangular area that dniws in a window so the next 
step is to implement that hmclionatily. 

MylBView is declared in the file MylBView.h. That file must 
be niodiJ'ied to declare some sort of stale inlonoalion. The state 


used in tliis example is a background color. To add tliat state 
imtilement the interface of the class like iliLs: 

^interface MylBView ; NSView 
\ 

NSColor ^backgrouodColor^ 

1 

@end 


The file My IB View, m defines the implementation of the MylBView, 
and that is where view-related code that gets executed by the 
palette shtiuld be plated. The main thing die view does is draw 
a background. Drawing for a view is accomplished by die 
method named drawRect: so add this method- 

- (void)drawRect^ tNSRect)aKec-t 
I 

Ibackgroundcolor set]: 

MSReci Fin ([self bounds!) ^ 

1 


Tile view fnust initialize its state, which is done by this method: 

tid! inltWithFraiQ&:(NSReot)aRa[:t 
i 

[super ini tW1thFrani(^iaRectl ^ 
backgroundColof " 1 [NSColor redColorl retain]: 
return self: 

I 


Because the view state will lx- stored in an aj>j>lication-related 
Interface Builder nib file ihe view must lx* able to store and 
retrieve its stale using die standard Ccxxia cixler. The following 
methods do that; 


- (id)lnitVithCoder:(NSCodor ')decoder 
I 

nelf = Isuper inltWithCoder:decoderi j 
backgroiindColor " [ [decoder decodeObjectf roislnl ; 
return selr: 

I 





u)wivjiiva,com 
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Application 
Builder 
Collection 

Reusable Cocoa frameworks for building solid Mac OS X applications 


SuperScrubher a 

Erasing the Risk of Data Theft 


1 you creaXt. proressionaMooking applications. 

No doploymeta licenses or royalties. 

Collection includes Rotiition ill Slider, Foi nis Iters, Calendar View & Pop 


Who's looking at the files 
onyovroldeowpoter? 

As a programmer, your 
fonipiilcr is filled with source 
code, design documents, and 
more. Don't give away your 
livelihood when you sell, donate, 
or rtmsign your used computer. 


Use Snpt’rSt:ntl>l)cr to ijermaoently erase 
ill the files and data from your hard drive, 
partition, or external disk 
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‘ fvo id)oricQdeWithCoder: (NSCoder *)ct>der 
I 

[s>up€'t encodeWithCadet::coder] ; 

[coder encodeObject^backgroundColor]: 


Phon^let 

Your Personal Telephone Assistant 


Finiilly, the view needs to Ixt iibic lo allow external objects 
(aillmjf code, such as an Inspector) to set and get its state. That 
is accoin[3llslied by these metlKxls: 

- (votdjRPtBackgrourideoior: (HSCoior •JaColor 

i 

IfCaColot ]= backgroundCoior) 

1 

IbackgroundColor releaBe )i 
backgroundColor = aColori 
[self fsetNoedsDisplay: YES]: 

I 


(NSCoIor *)backgroundColor 

1 

return backgroundColor; 

I 

If the view gets removed then it must lx." able lo release its 
resources, lliat is accomplished by the dealloc method: 

* (void)dealloc 

I 

[backgroundColor release]; 

[super deailocj; 

1 

A view will lie removed (released) if tlie window it is on is 
closed (and tlie window is marked to release), if it is cut from 
the Interface Builder window it is tm, or some olher condition 
like that so it is important to release its resources. 

Tliat is all that is needed to define the state and 
functionality of the view. The next step is to Icxrate that view 
on the palette itself. The palette interface eonfiguralion is 
mainiuined in an Interface Builder file called 
MylBViewPalelte.nib. Find ihai file within the project and 
doiihle click it and drag out a Custom View (from the Qx^oa- 
Containers palette) onto the Palette Window. Click on tliai 
CustomView, tyjie Apple-5 and in the resulting Custom Class 
Inspector find MylHView and click it. The CustnmView will 
now instantiate as a MylHView instance^ w'hich means the 
drawRect: method and other code implemented above will 
be executed by the palette when it is mn. Save the nib file 
and build the result in Project Builder. You are done making 
the palette, so make sure to quit Interface Builder and 
Project Builder. 



• who is atllmg brforeyoa fake the calL 

• Reporti to you how much time you on the 
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• iMcates the number in ymtr phone book then dials 
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Testing The Simpij- PAumr. With An Example Appucaiion 

Using the Finder locate the palette, named 
MylBView.palette, that you just built, Nonually it is in the build 
subfolder of the palette projecu Double click My IB View, palette to 
launcli Interface Builder and to add the palette to the list of 
palettes to use in Interface Builder Sc‘e the resulting red 
rectangle in the Palette window of interface Builder? Tlial is 
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programmers lo levenige our hardware without low-level USB 
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your view drawing djcru. You can now add it to your own 
appUcalions when you want to. 

To make an example application, First quit Interface 
Builder, 'fhen launch Project Builder, choose File > New 
Project and select Application > Cocoa Application. Click 
Next and save it as My Application. MyApplicalion has a file 
called MainMenu.nib in the Resource Folder of the project. 
Double click that to launch Interface Builder, drag your red 
rectangle onto the resulting window and then save it. You 
cannot run it yet because, while Interface Builder can 
execute MylBView through the loaded palette plug-in, 
My Application cannot because it is a completely separate 
program. You must first create ihe MylBView class in the 
MyApplication project. To do that click on the Classes folder 
then click File > New File and choose Objective-C NSView 
subclass, then name it as MylBView and click Finish, The 
results are two files called MylBView.m and MylBView.h. Add 
to the content those files the same lines of code that you 
did for the corresponding files in the MylBView palette 
proiect. 'I'hen build and run your application from Project 
Builder, When am, a window comes forward with the red 
rectangle defined by the MylBView instance. 

You have just made a palette and a custom ujipliolion that 
uses that palette to do stnne drawing. To extend it, go hack to 
the palette project and add additional state and implementation 
code. Repeat that prtxess until you gel the type of drawling you 
want. Ihe next sections descfilK^ lu>w to reivne the palette a bit 
and then descrilx^ some of the broader issues encountered in a 
more advanced palette implementation. 

Adding An Attribute Inspector To The Simpu: PAurriE 

Notice that the view^ of class MylBView^ in Interface 
Builder has no Attrihutes hispedor. That is because you did 
not add any controls to the inspector in the MylBView palette 
project. To do that launch your MylBView project, go to the 
Resources folder and d<Hihle click ilie file named 
MylBViewInspectornib to launch Interface Builder. Within the 
Class tab follow the class hierarchy to IBInspeclor where you 
will find st>mething like this: 

NSOI)jea > IBInsjXilor > ^KOlFCrNAVlBASIDHNl'IHlHRljinsfxctor 

You need to change the last pan to MylBViewInspectOf to 
make tilings work, obviously a small template parsing problem 
wliile making new ][\ palettes Clhis bug is in version 2.3 of 
Interface Builder and may be fixed in later versions). Tlien click 
<3n Uie Instance tab, click on the Filers Owner and in the Custom 
Class inspector click MylBViewInspector. Now you will l>e able 
to make connections, add new outlets and actitjns, etc. to the 
Filers Owmer 

The palette controls the view of class MylBView. That view 
has a background color a,s its only added attribute. Scj, a likely 


impix>vement is to add a control that modifies c<j|or. To do that 
drag a color well onto the }n.spector Window, control drag from 
that color well to the File's Owner and then connect the color 
wt:ll's target ouiiel io the ok: action of the File's Owner. Then 
save the nib file and quii interface Builder. In 
MylBViewlnspector.m mtHlify this ctxle: 

• (void)ok:(id)sender 
t 

/* Tour code Here */ 

[super ok:sender]: 
t 

lo this: 

(void)ok:(id)sender 
I 

id inyVi4?w = [self object!; 

ImyView setBackgroundColor:[sender eolorll: 

[super ok:sender]: 

I 

The color w^ell's action is the ok: method which, by the 
implementation alxjve, will modify tlie background color of the 
view. Fveiylhing is done so rebuild the MylBView project. Next, 
launch your MyApplicaiion project, double click MainMenu.nib to 
launch Interface IkiildcT again (thi.s time it ItKtds with the new 
inspector), dick on your red view and ty'pe Apple-1 to bring 
forward the Attributes inspedot This time it ha,s a color well on 
it. Click on the color w'ell frame to bring ft>rward the color panel 
Change the color and watch the color attribute change in the 
color well and, because the target of the well is the ok: method, 
wliidi forw'ards the aciion to your view, ymir view's background 
color alst) changes. 

You have liuilt a pulene. made an example applrcalion 
using tliat palette and extentled the palette to (xmiii a state 
change (jf your own view within Interface Builder. 'Hiat is a 
pretty gooil start, l)ut a lot of iin[>ix)vemerus and design issues 
have yet to be touched upon, t he next sections outline some of 
those issues, 

SOMJ: PROBlJiMS WiTH ThE SIMPLE PAIJHTE 

'Hie simple palette has already come a Unig way and it is a 
gCKXl starting [xiinu but lliere are quite a Few' problems witli it, 
some of which are listed liere: 

• 1he declaration anti definiiion of MylBView are maintained 
in two places. They are in tlie palette projet'i and separately 
in die example appliairkin pro^Tt anti for every new project 
thai uses that view' class they liave to lx.* placed there too. 
lliai can cause a code maintenance issue. T(> solve tliis 
problem ytju can make a third projed which is a rramew'ork 
anti move the declaration and deliniiion of MylBView to that 
framework and then link the palette, the example application 
and any future projects to that framework. 

• The implemenEation of the ok: melluid assumes the 
sender Is a color well. That is problematic because if the 
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Final Cut Pro, Final Cut Express 
and iMovie 

I How to Set Up a Home 
Recording Studio 

I Music Editing on Your Mac 
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proiccLion U> applicatioas using this system, i.e.: an error on 
the server side wiil not terminate the client side process. This 
also has a good programming benefit in that there are no 
namespace, process address space, or run rime resource 
conflicts between the client and the server. 

The server is fully programmable, extensible and has access 
to all the aitril)utes of the frameworks it depends on. That means 
the server can be extended to make nc^arly any type of report or 
graphic and access any database or other dam source all while 
tnainiaining the infr^istnicture of the client server model and 
Interface Builder implementation, .so lliat conceivably all output 
of the frameworks can l'>e inserted into Interface Builder witliout 
the problematic i.ssues encountered in the earlier homogeneous 
implementation mentioned above. 

The graph palette was made in the same way as the Simple 
Palette described above, except that the state information is not 
a background color, but rather an input string, chart type and a 
Peer Visual Server connection. Other than that, the two palette 
implementations are basically tlie same. 

The other advantage to the graph palette miplementation is 
that the client may be a Coct)a, Java, CarfK>n or other type of 
implementation while tlie Peer Visual Server can maintain its 
own implementation criterion. You can find an example of this 
lieierogeneous tise ai www.marketocracy.com w^here visual fc)rmars 
from the Peer Visual Sewer help ineml)ers manage veiy 
successful mutual funds like ihe fund shown in Figure 4, 


Net Asset Vsiue 



Figure 4: Of Custom Peer Visuai Serifer From 

wum\marisLH(}Cracy.com (Cot4nt^y of Marketotracy®, fnc). 


In this case, the Peer Visual Seiver outputs its results to a web 
im)W.ser, but Ix^cause of the client seiver arcBitetture that same Peer 
Visual Serv'er can usexi to imke a desktO[) a[3y>lication witliout 
any alteration of the server ctxie. ihe design is also used to offdoad 
the data <[uery, modeling compuration and resulting visualisation 
jX)rtion of tlie display to a separate computcT .so lltal it enables tlie 
interface Builder palette to incoipoiate distiibuted computing. In 
addition, the graphical layovit of the output is maintained in a 
sef>araie coded state maintained iiy a widget builder called Vvidge! 
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access to arrribiites that were many times greater than all of 
those available in Interface Builder by default. The system 
depended on running two independent docunient and 
inspector systems in parallel. It worked ieasonal:)le well, but 
sLilIered IVcmi a major design llaw: jl gave [he ultinnite 
Ilexibility to solve a vast ainounl of prol)lcinSi but did not 
solve the pertinent problem well. That i.s because users of 
[lie pa Idle typically did not a.sk *'how can I adju.si that 
atlribule?’\ rather they a.sk: ""how can f get a line ploi” or 
similar final result. 

After many other design attempts a client .server 
iinplcntentalion was chosen. Thai system, called the Peer 
Visual Seivei; is diagrammed in Figure 3- The server is 
capable of handling about KXIO sinuilianeons requests. Some are 
transitory such a.s rec|uesf.s from web browsers and some are 
dedicated like requests from an Interface Builder view. For eacli 
graph dragged from the palette to the a[)plicatiun wiiKlows, such 
as in Figure 1, a new dedicated connection is made, fhe 
cormections are load balanced amongst several servers (2 [>y 
default) and delegated to diiferent threads witliin the sciA/ers. 
The multi-process, threaded and paralle] nature of the 
iin pie mentation means tliat a niulti CPU computer is used to its 
fullest extent by the Interface Builder views. Tlie other major 
benefit to this design is that the client applications do not have 
to load in tlic fra me works that make the graphs bec:au.se they 
reside in another [>rocess space. 


Client Process Spaces 


Interface Builder View 


Interface Builder View 


Interface Builder View 


Interface Builder View 


Server Process Spaces 


Thread-1 


Thread-M 


Peer Visual Serve r-1 


Thread-1 


Thread-N 


Peer Visual Server-N 


Load Balancing Determines Which Server Gets The Connection 


Apache Web Server 


Web Browser 


Local Computer 


Remote Web Browsers 


Connections, upto 1000 possible: 

.. Transient 

- Dedicated 

I m 1111 M u It i pie S i mu Itaneou s Con nection s Made By vvidger BuHder 

figure 3: Pf^-r Visual Seruer And The Inter face Builder Palette 


The design also incorporates a server monitor that start.s 
the senders on demand, checks for valid connections, rolls 
over servers in the case of an error, and in the unlikely evcnl 
that generating a graph encounters a terminal error the 
Monitor restarts a .serv-^er for a client. This gives added 
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Live Channel Pro 2.0 

The world's first live television 
Studio in software 

For live events, lectures, conferences, 
announcements and business presentations to 
local or remote viewers, there is no solution 
better or simpler than Live Channel Pro, 

With Live Channel Pro, anyone can produce, 
broadcast and stream Live video and audio in 
real-time, on any network, without technical 
expertise, special equipment or high costs. 

"Live Channel is frankly amazing. Go out and get 
a Mac il you have to - it's worth it, just for this/' 

- QuickTime’s Bible: QuickTime for the Web 

"An unprecedented solution for communication 
& education." - Ron Okamoio, Apple, VP 

"A miracle ... Belter than any other slreaming 
software. A Must Buy." - Creative Mac 

"A quarter of a million dollar broadcasting 
system on your desktop or laptop." - Dale 
Sorenson, Sorenson Services USA 

"This product will simply rock your world." 

- Software Best of Show, The Beacon Award, 
Macworld SF 2001 

"The most flexible and innovative technology 
solution for Internet video." - Richard Millwood, 
Apple Distinguished Educator 

Download Live Channel Pro for free 
evaluation at www.channelstorni.coni 

Enjoying WWDC? - Experience 
Live Channel Pro 2.0 and you will enjoy it more! 


inspector is updated to have two controls then the sender 
can be either one of the controls. There are a few ways 
around this issue, the ea.siest is to assign each control to 
an ivar of tlie mspector and then to test which tvar the 
sender is. The other option is to make additional action 
methods and make each one of those a target of only one 
ctmtro!, such as this: 

{v0idJthon&C!Bac;kgroundCol£}rJ {id)eervder 

id myViev - [self object]: 

[ayView setBackgroundCoior;[sender color]); 

[super ok:sender]; 

If you add new states to MylBView and implement their 
store in the coding methods then MyApplication project 
will stop working. That is because the slates were 
previously stored in ilic MainMenu.nib file as defined by 
the old version of the coding methods which are 
inconsistent with the new' version of the coding methods. 
The slate coding methods shown above rely on the old- 
sty ie coding where the iinplementer needs to manage 
versioning manually. The newer key-value type archiving 
solve.s this problem to some ex lent. This Ls.sue is easily 
dealt with, hut it is something that needs to be kept in 
mind while iterating a palette design. 'I he easiest solution 
is to iterate the palette design to a final product without 
making an example project, release the palette at that 
version and tlien deal with versioning issues in a future 
release, but not necessarily while iterating the design of 
I he palelte. 

Many non-essentiai details, such as declaring the method 
prototypes in header files and iinplemeiiiing arnibuie loading 
ctxle in the inspt^ctor have not been shimn here and aR* left 
k) die reader to implement. 

Other than that, the simple palette project is reiidy to lx* 
extended by adding more state variables (ivars), attribute set 
and get methods, coding additional states, adding more 
controls to the inspeclor and, finaily, Ixcause il*s all about 
draw'ing, to use that state infonnation for drawing in the view's 
rectangular region. 

OEsiciN Of The Graph PAurnT 

The example palette described above is a handful of 
lines long, pretty small. But what happens when the 
attributes, feamres and code grows? How does the paradigm 
scale and how would it need to be changed to accommodate 
scale-dependent issues when the code base approaches a 
million lines of code? The programming environment on 
Mac OS X permits an arbitrary amount of code to be loaded 
into Interface Builder as Prameworks and Bundles so 
conceivably anything can be insened into Interface Builder. 
Party on one of our palette implementations loaded all of 
our frameworks, initialized our whole environment and gave 
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Riiikier'^ whic’h Ls dtisigned to handle data-relatcd diagnimming 
and graphs (ihe ilgure.s for aiticic were imde witli Vvidget 
Builder). In that way, the grapli state and HincUon Ls paiTitioned 
from the Interhice Builder palette implemeneaion U), for example, 
if does nor suffer from the versioning problem descrilxxl alxwe. 

Conclusion 

For simple functionality, such as a dial or simple control with 
few attributes die nonual Interface Builder plug-in model tmy be 
sufficient. But that model suffers from tmny ills found in 
homogeneous software architectures. Those tils were mentioned 
in previous sections and are fundatiiental to large-scale processing 
and software design and are not unique to Interface Builder, llie 
chent server architecture of the Beer Visual Server aridressed diose 
ills in a smaight Ibrward way and broadeas the applical)ility of the 
ijuplementation by j)ennitting reuse of die system wirli the 
Interface Builder graph palette as well as different client 
envirnnmenLs sut:h as Ccxxra, Carbon and Java and difl'ereni client 
interfaces from desktop applications to web browsers. In that 
sense, Interface Builder is not a tool to solve all probletTLs, but 
rather a tool that permits easy access to heterogeneous systems 
from within a desktop apidication tlirough palette extensions. So, 
it is the recognition of that applicability of the Interface Builder 
palette paradigm that is the main point of this ariic:le. 

Referhnces 

You am downJaid the gniph palette and supporting ecxle, 
example pn)jt:cu dtx umenlaiion, gntphing server, Vvidgel Builder 
layout application and other resources at 
http://ww\/v.wi,conri/download/widgetLiser. You am als<.i get one million 
dollars, pn)fessional hind-managmcnt Uk>I.s wiili great kxiking 
rejxDits and graplis arid liave the opportunity^ to become a very 
successful mutual fund manager at www, niarketoaacy.com. 'Hie 
dollars are vinuaf Ixit the underlying software and rcsulLs arc noU 

Legal 

V\1 Is a Registered Trademark of Wimaging, Inc. Wl, 
Vvidgel, Vvidget Builder, Vvidget User, Peer Visual and 
Wimaging are trademarks of VVimagtng, Inc. in the United 
Stares and world wide, Markeroc'mey is a Regislere<l 'fradc^mark 
of Markeiocmcy, Inc. References to Marketocracy are for 
inlbrmational puq:)Oses only. 
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PATCH PANEL 


Hy John C. Welch 

Musings on the 2003 WWDC 


IT types finally get a room of our own 


Welcome 

Wdtome t(3 a rebirth of sorts. Well, maybe ‘remodeling' 
woukl he II belter term. This is the second version of my 
network in|* ^ IS column for MacTecln No^ I he content is still 
going to he focused on networking and IT, with some 
AppleScript on the side, I haven’t suddenly become a Cocoa 
programmer lUit weVe going to 117 and hrxsaden the input 
range a Iht. I'm also going to he the Network AdininLslration 
editor, so with any luck, I'll be able to sucker, er, recruit 
some of my peers in the Mac IT community to contrihure 
articles as well. 

1 think that’s an important step to take. No one t^rson can 
write well on eveiy' issue that affects I'l’, h’or one reason, there's 
no way fcjr one fXTSon to have tiliimale c'osniic experience in the 
field. Por anotliei; the IT / Networking profession is simply LeX) 
diverse. 11* / Networking professionals get hit with an ama?ingly 
wide range of pri^hlems that mosi other joiis don'f come near. 
I'm not becoming proficienl wiLii IM>F, InDcsign, and PDF hams 
hecau.se I’m bored, 

Sc3, I his column, and related an ides need to reflect that to 
l>e of service to llie IT / N el work professionals who read 
MacTech, or who don’t think that MacTech has much to offer 
the non - programmer, So, hopefully, wvll be able to bring 
more folks into the MacTech fold, and that lx.mefits everyone in 
the end. 

Well, enough of that, on to the business at hand. 

The 2003 Apple Worldwidl DiiVULOPciis Coni ekence 

Outside {)f perhaps MacHack, the WWfX^ is the most 
imponani technical conference in the Mac world. In I ruth, it s 
the only technical conference for the Mac world. (MacHack 
attendees calm. Pm not dismissing Mad lack by a long 
shot. Bui it has a different focus than the WWDC and 
rightfully so. It's a programming conference for programmer 
,seeking to push the limits of what the platform can do. That's 
not really what the WWDC is about.) I've alw-ays found it 


interesting that people in the IT field have blown off the 
WWDC because the weren't developers, when the fact always 
was that you could hit over 60% of the sessions and not see 
ten lines of eode. 

This year, you don’t even have to make tliat excu,se. Tliere's 
an Enterprise IT tntek this year, an<i from tlie looks of the 
sessions, it’s not just a handful of stuff to keep the IT ty^pes 
happy. The track is a serious collection of sessions that will give 
not only sysadmins, but interna I/enterprise developers tlie kind 
of information that they need to Ix^trer run their Mac OS X 
systems. There's also an Enleqmse Feedback Forum, One note 
on the Feedback Forums. If you go to the WWDC, go to any and 
all Feetlback Foaims that affect you. You get a chance to talk to 
the folks making decisions for things like AppleJ>cripi, 
Documentaticjii, Networking, etc. in a near one-on-one setting, 
'file Feedback Forums alone are a fairly compelling reason to go. 

That lirings up another advantage of the WWDC: 
aUendance, A typical Macworld Exfxj lias a liuge number of 
Apple people in attendance, Unfoitunately, there's anywhere 
heiween 50,0(X) and 80,0(KJ people all wanting to talk to them. 
The higge.si WWDC I've attended lo dale ha<l a little over 3,000 
attent-lees, and more engineers than at Macworld Expo. Do 
ihe matin and you’ll see that getting face time with the people 
you want/need lo talk to is far easier BiU ifs nol ju.st Apple 
people, Microsolt, Adobe, Nett>pia, Stone, Sybase, Oracle, HP, 
Xerox, almost any Mac developer that is %vorking today will have 
engineers there. 

Note that I'm saying engineers. If you want txx>lh - baiies, 
this is nol the conference for you. But if you w ant to talk to the 
people writing the code, or managing the people w'riting the 
ctide, and making the decisions for the next caide lo be written, 
the WWDC i,s a gold mine of contacts. As an IT type, I have 
found that the friendships, both personal, and professional that 1 
have made over the years ai the \XWDC have been wurtli ilie 
entry price and then some. 

This year, we get a nice added feature, namely a first look 
at Pantlier, the next major release of Mac OS X. For IT / Network 
managers, this is anotlier invaluable benefit of the WWDC. You 
get an advanced look at ,something which will affect your life. 


John Welch <jwefch@miT,edu> is an IT consultant for MIT Central IS, and the Chief Know-It-AJI tor TackyShin. He has over fifteen years of experience 
at making computers work. John ,speciaiizes in figuring out ways in which to make the .Mac do w'hat n(j|-K>dy thinks it can, showing that tiie Mac is 
the .superioi administrative pisilfonn, utid teadiing utliers how to use it in interesting, if soineiiiiies liigtiiening ways. He also does tilings dial don’t 
inv<j]vc compulenry' on occasion, or at least that’s the rumor. 
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audio recording • editing • effects 


and you get to do it while the |>eopie niiiking it are walking 
around tlie ,same room iis you. That tloes tend to make getting 
your questions attswered a kn easier. 

As far as predictions go, l*ni not making any. I'm noi really 
sure wfiat lo prediti, mt^t of the information I'd talk about lias 
been announced at the WXX^DC website, 
(http://developer.apple.com/wwdc/), and for anyiliing ef.se, well, tluu^s 
whai nimor sites are for. Frtim the session schedule, I’m going 
to l>c* busier at this WWDC than any Tve lieen to liefore, and 
that’s saying sontclhing. Fanltier info is Cobvifuisty) high on my 
list, as is any liardw'are information 1 can get my hands on. I’d 
like to see more AppleScript se.H.sioas, Ixit then, I always want 
that. 1 am pleascxl to see a session specifically on AppleScript lor 
Sysadmins, and can guarantee that Fll be at that one. What I 
really need is the ability to clone myself for alxiut a week, so 
that I can hit every session I want to hit. 

CoNcmsiON 

So, again, welcome to Patch Panel, I hope it will give you 
the kind of information you need as an IT / Netw< irk manager 
to txiniinue reading MacTech, or start a new subscription. 1 
also hope to see as many of you as possible at the 2003 
WWDC, so that Ap[)le gets ilie mes.sage dial taking care of iV 
is a good thing. 
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and adaptation solutions while supporting you in the distribution, communication, 
and sales of your products in international markets. 
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REVIEW 


By Vicki Brown 

Regaining Control of your Inbox 


Ready, aim, fire! 


SEPARATING THE WHEAT FROM THE ClEHE 
Tlie populariiy of the Internet, plus inaeases in connecUvity 
(and email access), has given rise to a corresponding avalanche 
of spam. We all know whai spam is - unsolidled junk email 
offering grxKls or services that we don't want, don't need, and 
often didn't want to know existed’ We ail agree that we would 
like less of it. bailing that, how can we wa^Je thn>ugli it, manage 
it, ancl delete it wiilioiil losing our desirable mail (or our minds) 
in ilie pnK.'css? 

Many "solutions*' have been propased Tode:il with ihe spam 
problem. Itiese range from anii-spaiTi fillers integrated inside 
email applications (e.g., the junk mail filters in Apple’s Mail) to 
standalone products of various levels of complexity, ease of ttse, 
effectivenes,s, and cost. 

My current st)luLion of choke is SpamAssassin 
(http://www,spamassassin,org), in combination with procmaii 
(http://www,procmail.org). I po.si-process the results tiirough my 
desktop email client, (Budora), for a very jxiwerful and accurate 
spam-killing .solution. 

SpamAssassin provkles many fejitiires, including: 

• user-configurable spam score threshold 

• ability to re-write Subject lines 

• user-c^onfigunibie filters, using Perl rt'gular expressioas 

• modification of existing Spam scores 

• use of statistical, “Bayesian" analysis 

• “auto-learning” 

• eiptional use of DNS blacklists (e.g., Real-time Bkickhole List) 

• optional use of Network Checksum Tests (services that 
compare message checksums to known spam) 

• “whitelisis" (From addresses that are considered OK) 

• Accepted message languages 

Note that SpamAssiissin and procmaii Ixith nin on the server 
side (where mail is originally delivered), not on the client side 
(i.e., usually not on the desktop) and neither has a GUI from end 
or a particularly “user-friendly’' configuraljon mode. If you, or 
your users, arc not technically inclined, 1 recommend that you 
choose a different path. However, if you enjoy tinkering, have 
some understanding of regular expressions (e.g., you’ve used 


Peri) nnd like to work with lexL-ba.sed ainfiguration files, you 
will find the SpamAssassin/procmail combination to be powerful, 
flexible and, more important, accurate. 

CONITGilRAllON 

SpamAssSassin comes pre-configured with a latge set of tests 
that it will perform on all incoming mail. In addition, you can add 
new tests, skip tests, raise or lower the “score" assigned by a 
given test or, using prcKmail, cause some mail to skip 
SpamAssassin altogether. Goto http://www.spamassassin.org/dQC.htmi 
to see more detailed dot:umentation. You’ll even find a pointer, 
at that URL to a SpamAssassin configuratir^n generator tool, 
designed to make it easier to customize an insLallaiion of 
SpamAssassijn with some common options. 

Much of the power of SpamAssassin comes from its 
configurability, its use of Peil regular expression pattern 
matching, and its interaction with |>rcx'mail. 

For example, many spammers liave started adding ever- 
dianging sets of numlx^rs to the ends of subjea lines, to fcx)i the 
simpler junk mail filters. One GUI-based ami-spam application I 
tried had a set of filters ilesignetl lo tiy^ lo catch mail of this form. 
The filters Irwiked like llks: 

if Subject ends in 0 

ar if Subject tnds in 1 

ot: if Subject eitds in 2 

at if Subject ends in 9 

This Is rather cumlx*rsome; worse, it tl(X‘srTt liandle the 
.sp 4 immers w^ho rhr<iw in a .space at ihe very end. SpamAssassm's 
approach is liodi slu>ricr and iiuire flexible, lliis regular 
expression matches any digit, followed l>y 0 or more whitespace 
chanicteiT), at the end of the Subject line. 

Subject ^ /\d\s*S/ 

SpamAssas,sin’s interaction wiili prcKinail also allow^s me to 
specify whether mail Ls even sent through the SpamAssassin 
filters. For example. 1 can specify that mailing list messages 
should be delivered direnly. This procmaii recipe checks the 
message headers ft>r < 3 ne that matches the given Reply-to string, 
sending mail from the SpamAssassln-*ralk list to my pre-defined 
default mailbox, without further processing. 
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Qt/Mac, the Mac OS X version of the Qt 
multiplatform C++ application framework, 
provides a uniquely unfair technological 
advantage in software development. Qt/Mac 
lets Mac developers develop in C++ on the 
platform they love most, while targeting 
additional operating systems, such as 
Windows or Linux. Qt/Mac also offers: 

I fully object-oriented, elegant API 


i U integration with Project Builder, allow¬ 
ing developers to use Apple's own IDE 
for editing, compiling and debugging 
Qt/Mac applications 

I OpenGL support, for sophisticated 3D 
graphics on the Mac 

■ native look & feel, such as the Aqua style 

Don't take our word for it. Visit us at 
www.troUtech.com/mac. Look at our list of 


■ single-source, multiplatform development solution Fortune 500 customers. Read what programmers 


native compiling and applications that run at 


say about Qt. Download the evaluation version, 


native speed 


and see how easy C++ development can be. 


Qt/MAC:THE UNFAIR ADVANTAGE IN C++ DEVELOPMENT 
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* *Reply to:. *spanui^sas5in-talk 
SDEFAULT 


Resists 

SpainAssassin doesn’t Liaually delete any spam. Instead, it 
ra^s eat:h picec of [nail it processes with a set of headers, e.g,, 


X-spam Status: Yes, hitB^fi.2 required«2.5 
tests=AWL*CLIGK_BELOW,FREE^TRTAL,HTTP_WITH_EMAIL_IN^URL 

fipanj_PHRASE^05Jti,VLB^spaja^OFFER^A,V!,B^TO N0T_NAME,WEB_ 
BUGS 

v6rf!lon=2*43 
X Spani'Flag; YES 
X-Spam Level; 

X"Spaai Checker Version; SpamAasassin 2A3 {1.115,2h20- 
ZC02‘10 IS exp) 


: 0 : 

• *X Spam Level: \\\\\\\-V‘\*\* 

/dev/ aiLll 

Other than th;«, all remaining mail is delivered. 1 have 
occasionally found false ptxsitives in iiiaQ with scores of less than 
10 ; i want to check tliat mail by eye. 

Here's where my third eckiI comes in. I ii.se Eudoni as my 
mail application and make extensive u.se of Cudora’s filter 
mechanism to post-process my potential spam, 1 separate 
potential spam by mailboxes and lalx^iing, based on certain 
criteria such as wdtethcr the message ctrniains my full name (or 
only my email address), how high the spam score is, and any 
other interesting criteria, I scan the "Junk" mailboxes a few Limes 
a day, pull out false positives (setting new filters to catch tliose 
the next time!), and trash the real junk. 


X-Spam-FJag is a simple Boolean; if a message i.s 
considered potential spam, the flag is set (and Uic value is YES), 
X-Spam-Level provides more information; one is given for 
each integer value of tlie spam score. X-Spam-Status provides 
full scoring information as well as which tests pawed. Note liiat 
some tests raise the spam score w'hile odiers are designed to 
lower it. After all tests have l>een run, the resulting score is 
('ompared to a (user configunible) thresholcf If ihe scx)re 
exceeds the threshold, the message is tagged as spam. 

I'he user gels to decide how to handle the mail after it’s 
been prtKessed and lagged, One possibility is to contimie 
procewing w'itli procinail. For example, the SpamAs,sas,sin docs 
assert that mail witli a score of 15 or liiglier is almost cenainly 
.spam (with 0.05% false positives, aemrding to SpamAwassin's 
rules/STATISTICS.txt file). After some use, 1 decided to lower 
this cutoff even more. 1 have configured procmail to delete any 
mail taggerl with a Spam score of 10 or higher, using the 
following recipe; 


e ©0 


f^livri 



INSTAUjVHON 

This is only a review, noi a luiorial, so the installation 
section will hand wave a lot. Yoii ll need a server machine 


•i, 

■'1 

/■J Cv.’ 

A A 



Now serving Cocoa® 
just the way you want it. 

Training for Mac OS X doesn’t have to be the same old flavor. 
Reserve your seat in a class at our scenic lodge location, 
or have experts come to you for Extreme Mentoring. 
Two weeks of on-site instruction and collaboration, 
customized to the requirements of your project. 
Book now for 2003. See why we're different. 
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rancH 

Intensive Classes for Programmers 
www.blgnerdranch.com 
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running vununl c>r*nix (e.g,, FreeBSL), Linux, or Mac OS 
X). if your *server runs Mac OS X, you1l need to ntake sure it 
has been C{)nfigiireci to deliver mail ItKXilly (e,g., using 
sendmail or qmail), i low to set up a seiYer is beyond tlic s<x>pe 
of this review. 

You should alsT) note that, allhougli Spam Assassin am he 
run without [irtx^muih its flexibiliry' (and power) intTcases wlien 
it is usei! ill conjunction with prfK:mail. SpaniAssassiii docs not 
include eexie to handle IcKal mail delivery; it relies on proemail 
(or something else) for delivery. Unless you know tluit a relialile 
‘"something else” is availalile, use procmaU. 

Frocmail may already be on your server; it is pre-installed 
on mmi *nix sysiems these days (use wherets procmail or locate 
procmail to eiieck, then read the documentation to determine 
how ro cantlgure pixxiiuiil for yinir server situation), If it's not 
pre-installed, download and l>uild prot:m:iil from the 
proctTiail.org web site. 

SpamAssassin is proliably not pre-insialled on your system; 
however, installation is simple. In fact, you'll probably he able to 
install it witlKiut first <iownloading the archive, SpamAssassin Ls 
written as a Per! hkkIuIc; the easiest way to install it is by using 
PeH's CPAN shell (from the command line, as rtxit): 

peri 'itCPAN -e shell 
0 conf prerequifiites^poticy ayk 
install Mail; tSpamAsea&ijitt 
quit 


Alternatively, you can always dow^nload the latest archive 
iVoin spamassassm,org, then liuild and install SpamAssassin 
according to the dtjcumentation. If you liave any problems, i>e 
sure to read the Installation notes on the SpainAssasSsin site. 
Check the documentation for more information on 
coiihguration, as well as useful oplioas. 

StfMMARY 

If you’re iwking for a ])owcrfui, flexible, and accurate 
soluiion to die spam problem, I recommend that yr>u consider 
the team of SpamAssassin and prtxmiail. Both programs are free 
and come with example recipes and suggestions for how to use 
them to your best advantage. Iktcli has a supfiori I'ommunity that 
you can draw ufK>n for as.sLstance and ideas, as well as mailing 
lists ro keep you informed. If you have a server on wliidt to 
install it (note that SpatnAssitssin can lx installed serv'er-wide or 
on a perniscr basis) and know (or are willing to learn ab<iut), 
regular expressions, SpamA.s.sassin may be the spam-killing tool 
you've txen looking for. Give it a try. 

References 

SpamAssassin home page: http://www.spajmassassin.cirg 
SpamAssassin discussion lists: htlp://www.spamass3ssin.0rg/list5.htnnl 
Prfxmiil home page: http://www.procmaiLorg 
l^rtxmaii disemssion lists: http://www.procmail.org/era/lists.html 



Ifs 3am on Sunday morning, 


Ifi THE SERVER fiTILL RUNNING? 


End the 
worry with 


L m . The simpie reliability 
\ w solution for Mac OS 9 and X 


f System-level Crash Detection ‘ ^ 

patented hardware-software integration ^ 

* Automatic Crash Recovery ^ 

system restart or power cycle, as needed ■ 

4^ Monitor Custom Applications 

software deveioper's kit and plug-ins included 

4c Scheduied Restarts 

cures memory leaks and fragmentation 

V Restart after Power Faiiure 

even if shut down by your UPS 

* Comprehensive Error Logging 

to help you track down probfems 

^ Simple Installation 

just plug in AC cord and USB cable 


Forsll these features plus six power 
outlets controllable by phone tones, 
schedules and scripts, consider 
our PowerKey Pro 650 Admin. 


www.sophisticated.cpni 

/ SOPHISTICATED CIRCUITS 


Copyrvght'S)2Q02 Sophistjcated Circuits. FnC, Kick-oftI and PowerKey are registered trader arks 
ef Sophisdeated Circuits. Inc. Mac CS a registered trademark pf Apdie Compiiter, Inc 






QUICKTIME 

TOOLKI 


by Tim Monroe 


Studio 54 


Developing QuickTime Applications with 
AppleScript Studio 

iNlTlODncniON 

In xmi priivkxifi an ides (The Cbctxmuts" in MacTecb, 
IXxetnlxT 2IXJ2 and ‘‘Animal Crackers’', J;inuary 2003X we tcx)k a 
l<x)k at devcki]Hng Quk'kTune appJit^tions asing Cocoa* Cxkxxi is a 
set of trameworks tor appfit:alion.s that am on Mac OS X; it prtwitk^s 
u kijge set of corn|x)aent,s, or classes, tliat we can use to build 
applicaiioas or oiiier software mcxJules. Iliese chisses handle Ixisic 
tasks like event ptoctissing, memory managenieni, and dam 
mani|Xilatk)n* as well as liiglier-lcvel tasks like displaying and 
niiinaging the grapliical Liser interface of an apfiliraiion. 

In iho,se eiirlier artides, we used the Objective-C language to 
acceaj tile various Cocoa frameworks we em[^loyed in our sample 
aj^jplication. It's jicxssible, liowever, to use otiier language?' as w'elf 
Qx’oa su[)|x>rts development using Java and, moa" recently, 
Ap[>leScri]M. 1he support for AppleScrif)! is pixwided by A{^)ieScnf}i 
Studio, a Lievek>pfiient envia)mneti! from Apple that we can use to 
create Mac OS X ap|)lotions that acxes,s C:tH:otfs classes ;ind 
pt'rlbnn oilier tasks using the AppleScript sch[Xing language. These 
are called Af}fA*Schi)t Slttdio a/ifffiadmis. 

In rfiis article, wc'iv going to .see how^ liuiltl an Aj:>pleScript 
Studio a[j])lication dial can optm and play QuickTime movies, 
IJeuiuse it s built on top of Cxx-oa, our siuiiple apfilicarion (tulkxl 
Scrijyreez) will a>nlbnii to the Aqua user interface guidcliiic's and 
will exliibii the Ixrliaviors typical of Caxtia apfilkatioiis. And liecHise 
it's prograiiuned itsing AppleSi ri]>l, it should lx* simfiler to write than 
our siiini^le Oi>juctive-C; ap|)licalitjn, MixiVeez. 

It turns out* howevei; that the vottibulary pn)vided by 
Aj:)[xleScript Studio for amtrolling the Cocoa Quick'l'ime classes 
(NSMovie and NSMovieView) Ls currently taidy limitetl. Even a ULsk as 
simple as resizing a window so that it fits the naiural dimensions of 
a movie will require us to go fx^yond Apt)leSai|)i ajid empkiy a little 
Ubjedive-C. 'that’s ihe bad news. 'Ihe gtxxl news is that it's 
extremely to cxill Objective-C code frotn our Ap[>leSLTipt code. 
Well lx able to wt^ive the rwf> languages logetlier into a astmless 
whole tliat hatidles Quk kTinic movies quite nicely. 

tSeciiLise we’ll need to lesuit to Objettive-C for prt of tJur 
pjx>grainuii!ig, it would pidiabiy lx gtxxl if you weie ala^ady 


familiar wiili at least the first article mentioned alx>ve (“'Ihe 
CocuajiuLs"), lliLs would also be gtxxJ lxx:aiise AppleScript Studio 
uses the same softwaa* dc‘velo[3inent rexis (Project Builder and 
Interfacv Builder) tliat we encountered in that article* I’ll step thioLigh 
the [process of kiilding ScripT^z as gradually as possible, hut Til try 
not to rqxat very much of ifie infonnation fotind in those two earlier 
articles on C(X(ki and QuicitTiine. 

Well Ixgin tills article l^y mking a firief kx)k at Apj>leScript. The 
AppleScript we need for this article is so simple that you can pick it 
up as we go along, even if youVe never worked directly witli 
AppleSc ript Ixfore. Tlien I want to fake a c|ui(*k kx>k at how we 
hatidle Apple events in our Qirixin .sample QuickTime application, 
QTSlielh Apple events are llie underlying meclianism by which 
scripts are able to a>nirol oilier appliattioas, and it's useful to see 
how QTShell handles them* Also 1 want to take a cjuick look at some 
ol' ilie scripting support offered by ilie QuickTime Player application. 

We’il spend most of our time leiiniing how to cieate an 
AppleSc’rifX Studio apj^lkation ifuu ean open a single window tka 
cuntiiins a QuickTime movie. You may iKXice tliat IVe clianged the 
g(Xil hea" skglitly visTevis llic earlier articles in this mini-series <in 
QuickTime devck>|)nient enviRXiments. In pfevioas articles, we set 
oursc‘lves the task of developing mulLi-dcxunicni QuickTime 
applications — tliat Is, applicatkins tliat allow tlx user to open several 
QuickTime movk^ in windows on the screen, manipulate them in all 
the sianduRl ways, and |X)ssibly also Siive any edited movies, In tliis 
article, our siimple iipplicaiion Sc:rip1'ee/ will allow the user to opt:n 
just one movie file; moa- imfxirtanily, altlxiugh ScripTeez supjxjrts 
cxliling t^xration,s, it tkxs not allow' the irscT to *s:ive any edited movies 
Imiv out into tlxir movie files. Tie neiison for iJiLs depiirttire Is simply 
that the limited vtx'sihylary cunently provided by AppleSt ripi Studio 
for tnantpulaLing QuickTime movies tkxs noi provide an easy way to 
save edited movies, 'lb do this, we’d need to resort to more Objedive- 
C, and w'eVe alntratfy seen how to do that in tlx earlier articles on 
QuickTime and Qxoti. Here I w^int tt) fcxxLS on whal\s dLqinctive 
alxjut Ap[iieStri]X liCiKlio from a QuickTime iinzgrarnmefs point of 
view, which of c*oiii^ is tlx ability to open and manipulale 
Quit kTime movies using the Apple^KTipl language, 

APPliLSCRin OvEKMtW 

AppleSaipi is an Hnglishdike language used to tronirol die 
ataions of computers and applications. It was introduced way 


I’ini Moiinic in a member of the Quick Time engineering team. You can contact Iiim at monrtie@apple.eom. The views expressed here are m n necessarily 
shared by lii.s employer. 
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back in Mac OS System 7,5 and has been part of the Macintosh 
landscajK* ever since, ’['he priimry appeal of AppieScTipr is its 
ability to aiiu>maie workflow — that is, to encapsulate a 
predefined series of steps involving one or more applications. 
Tlicse steps could lie accomplished with die applit'iidons direcily 
(using the mouse and keyboard) but often at die risk of tedium 
and error. Sup|>ose, for instants, lhat we've got a large nuinlKT 
of QuickTime movie files that need to fx.* hinted ,so that they can 
lx.* streamed across the internet. We could open each file 
individually in QuickTime Player and select the appropriate 
menu ifeni.s to add liini tracks to the movie; it would be far 
l.K*lter, however, to constnict a script tliat accomplishes this task 
automatically wlicn we drop the movie files onto die scrip! file. 

Writing Scripts 

A script is a si?c|uence of lines of text (usually corUained in 
a file) that can lx executed. Here is a simple one-line script: 

tell application "QTShell" to open the file "TtD:Sample.roov" 

This line of script will launch die applic'ation QTShell (if it’s not 
already running) and instruct it to oixn the specifted file. 
Interestingly, this line of .scTipt dexs not cause QTShell lo 
become the froniniosi application. If we want that to hapi>en, 
wc need ro explicitly activate QTShclf like this: 

tell application ’’QTShell" to open the file "HDiSample.raov’’ 
tell application "QTShell" to activate 

And wc can simplify the.se two lines by using a tell block, which 
Specifies the default targe! for !he statements it contains: 

tell application "QTShall’* 
open the file “HD:Sample.mov" 
activate 
end tell 


Words like "the” are opdonaf ;md sesme words can lx 
abbreviated, (for insumce, "application” can be abl^revuited as 
“app”,) AppleScript also contains facilities for cxe<.tjting statements 
conditionally, repeating statements multiple times, assigning values 
to viirkibles, deftning suhrouiines and error htmdlers, and so forth. 

Apple provides an application called Script Rditor that’s 
useful for creating and testing scripts. Figure 1 shows a ScTipt 
Editor scrijit window. 
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As y<Hi am see, the window contains a tjuiion to am the script 
in ilie window. Typically, lu>wcvcf, scripieni want to package 
their work as a slandalone double-clickable appiicaiion, called 
an a{}!>ki. We can create an applet using St;rij>t Editor by 
selecting the ""Save As../ menu item and then choosing the 
^‘Application*’ formal o|Mion, as shown in Figure 2, 

save 

Sm;As: OptnCtTIlii_ 

Formn: 

WNer*: . _ t*l Q 

_SUiv0P<'' 

^ N«vtr Show Suiitufi 
Reqatre tht ClMtlc 

I f CaftctI ^ § Stm 


ff^giire 2: Creciting an af)j}le! 


Handling Apple Events 

Not all applicatiojis can respond to scriplcd instaidions. An 
applicatioa that can — railed a .^cripiahleappliC€ai(m — must be 
able to receive and process Apple events, Apple ettmis are 
messages sent from one application to ancjtlier lliat contain 
attributes (specifying the event clas,s and kind) and po.sNibly also 
parameters* (An apfilication can also send Apple events to iLsclh 
and that is sometime useful.) 

Classes of events that apply to specific kinds of objects are 
collected together into what are called suites. For example, the 
■|ext suite contains Apple events that apply to cliaraciers, 
wt>rcls, paragraphs, text style.s, ant) so forth. And the 


QuickTime suite contains Apple events ihiit apply to 
QuickTime movies and tr;icks. 

Our sample application QTShell is scnptalile, l>ui it 
stJpporLs only the four Apple events that must l>e supported by 
any scriptable application: Open Application, Open Documents, 
Print Documents, anti Quit, It does not support any other 
events* Tn particular, it does not support any of the events 
belonging to the Quicklime suite. So W'c can launch Q'l'Shell 
and get it to open a specific movie file by executing the scripts 
shown above, but it di>es not know how* to start the movie 
playing (for instance). 

In the Carton world, Apple events are sent to an 
application as high-level events. In the function 
QTFrame_HanclleEvent, well see this case blcH:k: 

case kHighIevei£vent; 

AKPcoceasAppleEvent(theEvent); 
break; 

I’liis simply passes the event to tfic Apple Event .Manager, which 
dispatches it to one of Ql’Shelfs installed Apple event handlers. 

It's actually quite easy to add the minimal level of scriptabiiity* 
tt) a Qirbtjn application. When it sums u(>, Ql'Shell calls the 
QTApp^lnstallAppleEventHandlers function, defined in IJsUng 1, to 
install event liaiidlers for the four required Apple events. 

Listing 1: Installing Apple event liandlers 

Q1 Ai>p_ Jiwi rtllApplrF.vcntHafidlef.s 
void QTApp_InstanAppl(?EventHandIer5 (void) 

I 

long myAttrs; 

OSRrr myErr * noErr; 

// ni.'C wlieiher flu* Appk‘ Event M;iiu|stT b :i\:atlabk‘; 

// if U is. tnstaJi huntllcrs fftr ibf fmir retiuireU Apple Evcnisi 
myErr Gestalt[geslaltApploEventsAttr. ^myAttrs): 

If CmyErr = naErr) I 

if (inyAttrs h flL << geaioltApploEvent^Present)) \ 

// create rtJvnine dmriplcjr?; fur tlie Apple evcni Iwndicnv 


One of the best-known and best-loved Macintosh development tools has gone X 
and now we want you to tell us where you’re going... 


AppMakerX Featiire 

J Carbon Nib Generator 
Cocoa Generator 
Flash Generator 
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Palm Generator 
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Feedback Foxrm 
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import It 
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ftfiandleOpenAppAEUPP “ NewAEEventHandlffriJPP 

(QTApp HandleOpenAppllcatiDnApplGKvf^iitf t 
gHandlfiOpenDocAEtlPP " Ne¥AKRventHandli»rUPP 

£ QTA p p_Ra d 1 eOp^? n B OC tuneii t Ap p 1 i; E van t); 
ftflandlaPrlntDocAEUPP ^ NawAEEventHandierUPP 

£QTApp_HandlePrintDocumentAppleEvent): 
gHandieQuitAppAEUPP NewAEEverjtHandle rUPP 

(QTApp^HandleQuitApplicationAppleRventl : 

// instiill the handlers 

AEIrnstflllEventHanriler fkCorcKveniClasa, 

KAKOponAppHcation* gHandleOpetiAppAEUPP* OL, false): 
AEInstallEveni Handler (kCoreEventClass. 

KAEOpenDocuments* gHand1eOpenDocAEHPP* OL* false); 
AEtnstaliEventHandler(kCoreEventClass* 
kAEPrintDocurEents, gHandlePrlntDocAEHPP. OT.* false); 
AEinsta 1 lEventHandle r £ kCo teEvetitCl ass * 
kAEOiiitApplicatl on * gHandloQn i tAppAElPP * OL* false); 
I 

1 

I 


There are^Users 
and Losers... 


The Apple event hiintllers in QTShell are fairly simple. 
Indeed, since our application must lx." launched by ifie opcaaiing 
system in order to receive the OpenApplicaiion event, we don't 
need to do anyiliin^ in responst? to that event except return noEir 
listing 2 shows the nugatory 0]KniAj)pliaition event liandltT. 

listiiig 2; Handling the OpetiApplication Apple event 

(^TApp_H4ndk'0|X'n.\ptdir,ttitjnAp|ikt\ic[U 
PASGAL_RTW OSErr QTApp_llaiidleOpenApplicationAppleEvern; 

(const ApplciEvent ‘theHessage. AppleEvsnt ’th^Beply. 
long LheRefcon) 

[ 

^pragma unused(theHessage, theHeply* theRefcon) 

// wc don't need to do anything ^pet iid when ofH*ntng the appiic;ition 
return(noErr); 

1 


And our l^riniDtx'umems handler (Listing 3) is just as simple* 
since Ql^hell dex^s not support printing. In this case* we return 
a suitable eiror. 

Listing 3: Handling the Printl>€>cuments Apple event 

QTApp^HandlcIVintlix'imiciitApplcEwiil 

PASCAL..RTN OSErr QTApp_HandtePrlnLiiocuinGiitAppleKvent 

(const AppleKveut *theMessage, AppleEvent “theReply* 
long theRefcon) 
t 

Ifpragna unused (thsM^ssage * theReply* theRefcon) 
rsturnter rAEEve ntNotHandled); 

1 


Q'l',Shell's handler for the QuirApplication Apple event is 
only slightly less trivial. It jiisT calls the QTFrame_Qu!tFramewortt 
function, us shown in Listing 4. 


Listing 4: Handling the < 


: event 

^Aj)p_HaiKlleQ%ttlA[jpH<.juorL\ppltEvtnt 
PASGAI._RTN OSErr QTAppJIandieQuitApplicationAppieEvent 

(const AppieEvent •theHessfige* AppleEvent *theReply, 
long thcRefcon) 
f 

^pragma unused(theXasflage* thoRnply* theRefcon) 


// ctosc down the cntifie framewod; ;*nd 4 ppHT“Urion 
QTF r 3 iiie_Qu i 1 F r shicwo rk t ) : 
return(noErr); 


These products are only available for the Mac OS, sc your 
Windows friends will still be losers... 
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The only really interesting Apple event handJer in QTShcll 
is the OpenncK'umenLs liandJen shown in Listing 5- 


Listing 5: Handling the QuitApplic^on Apple event 

QTApp_HaiKlU“Quit AppI icatu in AppkEvcni 
PASCAL RTH OSErr QTApp^HandleOpetiDocumenLAppleEvent 

(const AppieSvent *theKessage, AppleEvent *theReply» 
long thaRefeon) 
i 

ffpragntii unused(ttic^HcpIy, thcRnfcon) 

long myindex; 

long mylremsInLlst; 

AEKeyvord myEoyWd; 

AED e s c L1St myD o cLi s t: 
long myActUfllSiae; 

OescType jryTypnCoda; 

FSSpec niyFSSpco: 

OSErr mylgnoreEtr noRrr; 

OSErr myErr = noErr; 

// the dircci p;imiieicT ;ind put it into niyDocLbt 
myDocList*dataHandle * KULL: 

myErr " AEGetParaKiDegc(theHessage* keyDirectObject. 

typeAELlst, &nyDocList)j 

// ojunt the dcjicripior rtconls in the list 
if [tayErr = noErr) 

isyErr * AECount 1 terns(&]ayDocList> ^myltemslnList); 
else t 

myRtr " noErr; 
tsy [lemslnliifit = 0: 

1 

// f>pen each spcdfkxl file 

for [my Index * 1: ray Index <= rayltemsInList: myTridex+-ll 
if (iiiyErc “ fjoErr) i 

myErr - AEGetNthPtr(^myOocList. myIndex* typeESS. 

&myKeyWd, irayTypeCode. {Ptr)imyFSSpec t 


sizeot'(rayfSSpec) . ^myActualSize); 

If [ayErr " aoErt) f 
FInfo myFinderlnfo: 

// vertfy that the file type ts M<nicFlkT^TX- 

myErr - FSpGetFinfo(&myFSSpcc♦ SmyFinderinfo): 

if CrayErr — noErr) ( 

if (liiyFinderlnfo. fdType = HoviefneType) 
//we've got a luovic tlk; jti»t open it 
{iTFrame_{)penMovieInWindo¥[NULL , irrayESSpec J; 
J 

1 

I 

If (ntyDocList *datallandle) 

mylgnoraErr ^ AEDispoaeDesci&rayUocList); 

return [tnyErrJ: 

J 


Norice that we reset the local vurialile myErr to noErr if 
AEGelParamDesc Returns an ent^r. lliat's lieaiuse, whenever oitr | 
ap[>lication receives the OpenApplicatinn event, it also receives an 
OfienDociimenTs event, even if no files %vcr explicitly specified to 
lx- opened. In that aise, AEGetParamDesc would return an error, 
which would otherwise lie retiimetl to the Apple Kvent Manager, 


Scripting QuickTime Player 

QTSlieU Ls fatrly uninteresting froin a sc'ripting point of view: 
we can launch it. get it to open niovies hies, and later tell it to 
quit. <‘)n the other end of tlie scriptahility s|>ectrum is the 
application QuickTime Player, which (from version 5.0.2 onward) 
suppoits an exteasive vocabulary of commands and object 
specifiej>i for controlling movies and iheir clemenLs. Por instance, 
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user interface to create customized disk image files^ 

for delivering software products via the Internet.'^^Oi 

■’ 

• Quickly create compressed, read-only disk image files f 
Customized disk image backgrounds and volume icons 

• Burn CDs from disk images 

^•^Assign multi-language license agreements to disk images 
Protect disk images with password authentication ^ 

• Automate the build process with AppleScript ^ 

• Create customized and easy-to-use installers 

• Execute shell scripts during installation 

^ Restrict installer privileges with user authentication 

• Create uninstallers for users to tracIVuninstall software 
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(subject to availability) 



Small Dog 

Electronics 

www.smalldog.com 
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wc am teLI Qiiick'l ime l-1ayer to open a specific movie and play 
it lYom ihc Ixj^inning with the scTijit shown in Listing 6. 

Listing 6: Playing a movie from the beginning 

pbiyMovieFroniStJirt 

tell application "QuickTime Player" 
open file "HD:Sample.mov" 
activate 
tell movie. 1 
rew1nd 
play 

end tell 
end tell 

Notice iliat \vc spexify tlic movie to l:>e [:)]ayecl by pioviding its 
index. This works nicelyt t^ven if Quicklime Player is already 
launched and already has one or movie movies open, l>ecausc 
the most recenlly-opcncd movie will have index 1. We coLild 
also specify the movie by name, hut file name we si>ecify needs 
to Ixf the name of the movie window^ (tvhichj in QuickTime 
Player^ is not always ihe basenamc of ihc movie I'ileX 

Or, we can tell QuickTitiie Player to delete every^ disabled 
track by executing the script show n in listing 7. 

Listing 7: Deleting all disabled tracks 

(Jek tt:Dis:ihlt:Lrihii:ks 

lcH appl fci31 f 00 "QuickTime Playet " 
open rile ’MIHiSample.ttiov" 

EicLivaLc 

if not [exists movie 1) then return 
stop every movie 


delete (every track of movie L whose enabled is false) 
end tell 

Note the parentheses in several of these stalcnicnls. The 
parentheses indicate that the result of the code inside the 
I>aremheses is to he used as an input value to the sratement that 
contains the parenthetical code. For example, ihe code “exists 
movie 1"" is evaluated and iis result, which Ls a Boolean value, is 
used as the input of the conditional expression If not^ Similarly, 
the result of evaluating the expression “every track of..is a /1st 
of disabled trac:ks; the delete command takes that list as iiif>ut 
and do and Ix^hold) deletes each item in that list. 

As I mentioned, the scripting vocabulary supported l>y 
QuickTime Player is quite extensive, and we could easily spend 
an entire article investigating it, Bui let's move on to our main 
task, building a Quick'lune application using AppleScript Studio. 

Tiie Projecj 

AppleScript Studio applications are Cocoa applications in 
wliich the Ctx:oa classes are manipulated using AppleScript 
stripis. Atx'ordingly, we'll use the same tools, Project Builder 
and Interface Builder, that we use to develop Cocoa applications 
driven I'jy Objective-C or Java code. 

Creating a New Project 

To get started, we ll launch Projea Builder and select “New 
Project.. / in ihe File menu. In the list of available projects, select 
"AppleScript Application**, as in Figure 3- 



Visit us at WWDC 2003! 


QuickTime for the Web: 

For Windows and Macintosh. Third Edition 
by Steven Gulie 
Available July 2003 


Interactive QuickTime 


Authoring Wired Media 
by Mattfiew Pe terson 

Availeble August 2003 
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Figure JL* Vk' Netv Project unnJow 



figure 4: We ScripTecz project iiindow 


Let’s save ihc projea W'iLli ilie name “StripTeez" in our 

home directory (the default kxation). Figure 4 shows ihc new Tlie ’"Product" ^— tfuil is, our appliaUioii — is shown in mi 

project window, with tlte top-level disclosure triangles ojx^ned, Ixuiuse it Imsn’t Ixen liuili yet. IjcI’s Ixifkl and am die application; 

W'lien we do that, well see iJie windt>w shown in Figure 5- 
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return NSApplicationHalii(argc, atgv) j 


tigure 5: dej'auit application window 

Eventually we'U need lo add a movie player view (of type 
NSMovieView) lo this window; hut Ixrfore we do thatj let's take a 
lcx)k at a eoufile of the files in the project. 'I1te file main.m Ls shown 
in listing 8. It s fusi like the main.m file that we cfit:ouniered in our 
Objective-C Qkxki application except tliat it adds a call to the 
ASKInitialize funition, to initialize the AppleScript Kit (a fniinework 
tliat fimvides the AppleScTtpi support for our application). 

lasting 8: Running the application 

mnin.m 

extern vnld ASKIniiializct); 

extern int NSApplicatJonMalntint atgc, const char *flrgv[]): 


Ftir present purposes, we will not need to modify main.m. 

'Hie file ScripTeez.appleschpt is where we'll place our 
AppleScript cotle. Out of the lx>x, it's etiipty except for a few 
lines of comments. 

Modifying the Application Window 

Lei's put a movie view' into the default window'. Open the 
MainMenu.nib file with Interface Builder. (The easiest way to do 
this is just to doiihle'C'lick the entry in the [project window.) 
Figure 6 show.s die main window for this nih file. 

eo0 B MairvMcnu.nlb 



Int mainCint arge, const char *argv[]) 
( 

ASKTiiitialixeO : 


figure 6: Ibc nih file 
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^^Without a doubiy the Premiere Resource Editor 
for the Mac OS ... A wealth of time-saving tools*" 
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distinct: improvement over Applets ResEdiL"" 

- MacTech Magazine 

**Every Mae OS developer should own a copy of Hesorceren” 

- Leonard Rosenlhol, Aladdin Systems 

^"Without Resorcerer, our iocalizaUon efforts would look like a ^ 

Tower of BabeL Don*i do product without Ur 

- Greg Galanas, CEO and President, Metrowerks 

**Hesorcerer's data template system is amazing."" 

- Bill Goodman, author of Smaller Installer and Compact Pro 

'Resorcerer Rocks! Buy it, you will NOT regret it*" 

- Joe Zobkiw, author of A Fruginent of Your Imaginaiion 

""Resorcerer will pay for itself many times over in saved time and effort*" 

- MacUser review 

"The template that disassembles PICTs is awesonutP A 

- Bill Steinberg, author of Pyrol and PETotds 

^Resorcerer proved indispeusible in its own creation!** 

- Doug McKenna, author of Resorcerer 
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Its own 82-hit List Mgr can open and edit very large data structures 
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Includes nearly 200 templates for common system resources 
TMPLs for Installer, MacApp, QT, Balloons, AppleEvent, GX, etc. 

Full integrated support for editing color dialogs and menus 
Try out balloons, ‘ictb's, lists and popups, even create C source code 
Integrated single-window Hex/Code Editor, with patching, searching 
Editors for cursors, versions, pictures, bundles, and lots more 
Relied on by thousands of Macintosh developers around the world 


Includes: Electronic documentation 
60-day Money-Back Guarantee 
Domestic standard shipping 


Payment: Check, PCs, or Visa/MC 
Taxes: Colorado customers only 


Extras (call, fax, or email us): 
COD, FedEx, UPS BlueAted, 
International Shipping 


MATHEM/ESTHETICS, INC. 

PO Box 298 

Boulder, CO 80306-0298 USA 
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resorcerer@mathemaesthctics.com 
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www.mathemaesthetics.com 














Sclcci the icon lalieled "Window" and tlien choose !he 
"Show Info" menu item in the Tools menu; in the window that 
appears, iinseled I he “Deferred" attribute (as in Figure T). 
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Fif^ure 7: Wc ttimiow attrihufes 

Now select the Gniphit'sViews icon in the toollxir of the palelie 
wimiow. Tile piileUe window sliould then kx>k like Figure 8. 



/'Xg«re 8: ncf^mphics metm (nmel 

Drag a QuickTime iam from the palette into ilie movie window 
and resize It so that it lcx>ks like l^igure 9- There is a ZQ-pixel 
border around eiuii edge of llie movie view\ 



Figure 9: 'I he ret^ised application uindow 

Next we need to conllgtire the movie view so tJiat it resizes 
corretily to maintain that lK)ider when the application window 
is resized. Select the “Size" panel in the Info window and set the 
springs so that they kwk like those in Figure 10. 

Q o }iifg _ 


tPCli rrinie 
tiPliM tea ^ 

T| Wda/hiia^ ' 
t 15 w; 

v: 10 HtHo 



Figure 10: Ihe movie view size aftrihuies 

In our 01:)}ective-€ Cocoa application MtxiVeez, w'e needed 
to jnake some connexions Ix-lween the movie view and our 
custom d(K:ument class, but tliat isn’t necessiiry here. Instead, 
well refer to the movie view by name in f>ur AppleScript code. 
So we neeri to give the movie view a name. Select the 
"AppleSiTtpt” panel in ifie Info window and set the name of the 
movie view to “movieView\ as in Figure 11, 
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Q Q NSMovieViuw lf?fo 

AppTeScfipt _ ~yi 
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► □ Key 

► □ Mouse 

► G mb 

► G View 


Script 

G ScfIpTecz.applescrtpt 


( New Script ( EdirScriDr) 

^ d 


Figure II: Ihe mime uiem mmie 

Wt; are now almost done ciinfiguring the applieation 
window. The final ilhng we need to do is attach some event 
luindlers Lo the application window'. These handlers specify 
some AppleScript code that will be executed when certain 
specific events (Kcur to ihat window, in ScripTeez, we care 
aix)Lit only two events for the window^ namely when it is 
opened and when it is closed. All other evenLs that pertain to 
the window will he handled autoniatically by the underlying 
Cocoa frameworks. 

To attach event handlers to the window, select it and 
then select the “AppleScript" panel in the Info window. In the 
top pane of ihat panel are listed the events to which we can 
attach AppleScript code. Figure 12 shows how to select the 
handlers we want to auac*h, the “awake from nib" handler and 
the “will close" handlcT. It also indicates that the AppleScript 
code for those handlers is to be contained in the file 
ScripTeez.applescript. 
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Figure 12: 7he window event handlers 

ff we click tlic “Edit Script" button in the Info window, that 
flic ofx:n and we 11 see skeletal event handlers already included 
in it, as in listing 9 hater on, we’ll add some meat to these 
event handlers. 

Listing 9: Tlie skeletal event handlers _ 

ScripTeez.applejicript 

- ScripTeez.applescripi 

- StTipTee/ 

- Gvalctt by Tim MonntH' ijn iTiii M:iy OK 2003. 

- Qipyright (C) 200,3 Appk‘ C^anipuicrJnc.All rescmfil. 

m will close theObject 
CAcId your stripl hen;-*) 
erid will close 

OT? awake from nib theObject 
(*Add yxmr scripi herc.l 
end awake from nib 


Conclusion 

Well, that's all we have lime Idr this month. In the next 
QuickTime Toolkil article, well set up the applicafionis 
menu and sec how to get ScripTeez to open and display 
QuickTime movies. 

CuliDITS 

Thanks are due to Scott Ekjngiorno for reviewing this article 
and providing some useful comments. 

Some of the strripLs for driving QuickTime Player are modeled 
on KcripLs available at http://www.applexom/applescript/quicktime. 
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By Scott Kelby 
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versatile time tracking solution for Macintosh, 
Windows, and Palm! 


www.trinfinity5oftware.conn 



By TLA Systems 
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3.1 is the latest version of the most 
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picture manipulation. 
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created using REALbasic and the people who create them. For more 
information about the Made with REALbasic program, please visit: 
<www.realbasic.com/realbasic/mwrb/Partners/MwRbProgram.html>. 





REALBAStC SHOWCASE 


Whistle Blower 

Enterprise server monitor and restart utility 
whistleblower.sentman^com 

Connect to and volidote the response from web servers^ 
cgi scripts and over 23 other types of servers. 

Send email poges and perform unaHended restarts via 
MosferSwitch or PowerKey. 

Shifts make sure that the person on coll when the server 
goes down h the one who gets the page. 

68k, PPC and Carbon 

Web based odministrotion lets you check on and restart 
your servers from onywhere. 

Customize your response to an outage with Apple Script 


email us at whi 5 tlebiower@sentmon.com 



r MAC MUSIC MANAGEMENT FOR ^ 
- SONY^ 5 TO 400 DISC CD CHANGERS ^ 



Control up to 12 changers (4,800 music CDs) 
' ^ Control Any Brand Stereo Receiver 
Play MP3 and other Sound Files 

" Plus much, much more!!! 

^ # ■ 

www.titletrack.com info@titletrack.com 



piPop 

Pop-up Hierarchical 
File Navigation and Launcher 



T elnetLauncher 

Bt>okmark and Launch your 
Telnet and SSII sessions 


SimpleKeys 

Set your Function Keys 
to type stuff for you! 


piDog Software 

http://www.pidog.com/ 


7lf/owTm$fffMmfofk Jtdmoi^ADaidapmeitt 



Got a great product built 
with REALbosic? 

Promote your product through the 
very cost effective REALbosic 
Showcase in MocTech Magazine. 

For more information, contact us at 

adsales@mactechxom 


Studio 54 


78 


MacTeCII • JUNB 2003 


































REALBAStC SHOWCASE 



db Reports 


Printing database driven 
reports from your REALbasic 
project has never beeh’ easier. 


\ 


Powerful expressions with aj 
easy-to-use interface make 
this an indispensable tool fer/ 
the REALbasic program] 
providing business solutidiTS. 


/ 




Download a free demo today. 
http://abDataTools.coin 


Corona 

accounting softiuare 



"Eas>- to set up, easy to use* 
anti excellent support from 
the developer.-' 

Five stars on VersionTrackerxom 
Four cows on Tucows.com 


• cash entr>' 
• invoicing 

• payroll 

• reports 


$64.95 


Ver^iiofi 1.9 now with; sales tax accounting 
"keytess eolry'* irt^oioes 
drag 'n drop accounts 


Free 30-day Lriul 

h tt p:// homepage. 01a c .CO m/ idle wild/Corona US . liq X 



A best friend for business! 

p.o. box 472 * aurora • onegon • 97002 
idlewild0mac .com 


Extend REALbasic with 
Advanced Piugins 


Spreadsheet Controls: 

We provide a wide range of spreadsheet controls for 
REALbasic, including multi sty ted and custom rendering 
spreadsheet controls. 
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* More than 32k of rows. 

* Classic, OS X and Wrn32, 
•Accelerated for maximum 

speed, 

* Images in cells. 
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Cryptography: 

We provide data encryption, encoding, 
compression and hashing for REALbasic. 

Supported Algorithms: 

• Encryption: 

- e-CryptIt 

- BiowRsh (448 bit) 

-AES (Rijndael) (256 bit) 

• Encoding: 

“ e-Cryptlt Flexible 

- Base 64 

- BinHex 

- MacBinary III 
-AppleSingte / Double 

- UUCoding 

• Compression: 

- Zip on Strings and streams (.gz) 

• Hashing and Checksums: 

-CRC32/Adier32 
-MD5/HMAC_MD5 
-SHA/SHA1/HMAC SHA1 


other Plugins: 

We have many other 
plugins for REALbasic, 
including plugins to do 
advanced MacOS 
Toolbox tasks and more 
custom Controls. 



Speed up developement and make 
more advanced applications 
by using plugins ! Get free demos 
at www.einhugur.com 



Einhugur Software 

sales@einhugur.com 

www.einhugur.com 
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Download your free 2-user, non-expiring, full-featured copy now from www.perforce.com 
Free (and friendly) technical support is on hand to answer any and all evaluation questions. 

ATI nactamaiid uSsd Tiftrtfn arv sHhnr Iha traEt^marka ur lagiiTBfHl tradofniirka of Iholr respective owiMrs. 


With rival SCM sy^ems, the only way to 
quicken the pace is to cut comers - but in the 
long run you pay the price with missed 
deadlines, uncertain contents, buggy releases 
and no way back to previous builds. 

With PeiiorcB^ the fast way is Bh/vays tha 
right way. Install il fast, learn it fast, execute 
operations fast. With other SCM systems, 
developers face an unpleasant choice: 
do ti the right way or do it the fast way. 

Perforce's speed and reliability mean fast is right. 
See how Perforce compares with other 
leading SCM systems at 
htt p :/Avww, perforce .CO nVperforce/re vs ews. htm I 


Ran at faff speed even with hundreds of users 
and miffions of Htes. At the ix>re of Perforce lies 
a relational database with well-keyed tables, 
so simple operations can be accomplished in 
near-^ero time. Larger operations (like labeling 
a release and branching) are translated into 
keyed data access, giving Perforce the scalability 
that big projects require. 

Work artyw/jere- Perforce Is efficient over high- 
latency networks such as WANs, the Internet and 
even low-speed dial-up connectiorts. Requiring 
only TCP^IR Perforce makes use of a well-tuned 
streaming message protocol for synchronizing 
client workspace with server repository contents. 


Devefop and maintain maftipfe codefmes. 
Perforce Inter-File Branching’“lets you merge 
new features and apply fixes betweer^ codelines. 
Smart metadata keeps track of your evolving 
projects even while they develop in parallel, 

Truiy cross pfatform. Perforce runs on more than 
50 operating systems, including Windows and 
nearly every UNIX variation, from Linux" and 
Mac OS X to AS/400 and more, 

integrate ¥irith feeding fOEs and tiefect trackers: 
Visual Studio.NET'* Visual C-h-’* Visual Basic*, 
JBuildei^, CodeWarrior^* TeamTrack^', Bugzilla™i 
ControlCeflier"'. DevTrack' packages* and more. 


Perforce 

SOFTWARE 

Fast Software Configuration Management www.perforcB.com 









From Prototype to PowerPlant: 

Pronto. 



Introducing the REALbasic*, RADicode", CodeWarrior" Bundle. 
3 simple steps to speedy product development. 


Prototype. 

Use REALbasicto prototype your 
ideas. It's the fastest, easiest way 
to get your product ideas to 
point-and-click. 


Convert. 

Use RADicode to quickly and easily 
convert your REALbasic code into 
Metrowerks PowerPlant framework. 


Complete. 

With time to spare. Finish 
coding your app in the familiar 
CodeWarrior C++ environment 


Get the Prototype-to-PowerPlant Productivity Bundle. Pronto. 

Buy it online now at http://www.metrowerks.eom/4/productivity 
See it in action and buy it at DevDepot at 
Appie's Worldwide Developer Conference, June 23-28, 2003. 

3 REALbasic’ RADicode" CodeWarrio 

wvvw.realbasic.com www. so ltd wave.com www.metrowerks.com 
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